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ABSTRACT 

Naval  shipboard  electric  power  systems  are  transitioning  from  the  relatively  simple 
distribution  of  ship  service  electric  power  to  extremely  complex  integrated  electric  drive 
(IED)  systems.  The  optimal  design  of  warships  employing  IED  is  presently  hampered  by  the 
lack  of  existing  simulation  computer  tools  for  analyzing  the  highly  coupled  and  controlled 
electro-mechanical  systems  characteristic  of  IED.  As  a  first  step  in  the  development  of  a 
viable  computer  simulation  tool,  the  numerical  algorithm  testing  program  WAVESIM  was 
created. 

The  key  contributions  of  WAVESIM  are  the  systematic  treatment  of  waveforms  as  an 
abstract  data  type,  the  development  of  the  terminal  description  of  devices,  and  the  use  of 
structural  jacobians  in  system  reduction. 

WAVESIM  represents  variables  by  waveforms  consisting  of  a  vector  of  coefficients 
and  a  waveform  type  code  indicating  how  the  coefficients  should  be  interpreted.  The 
principal  advantage  of  using  waveforms  over  conventional  discrete  point  methods  is  the 
avoidance  of  unstable  integration  techniques  since  for  most  waveform  types,  integration  and 
differentiation  are  linear  matrix  operations. 

Devices  are  described  in  WAVESIM  by  relationships  between  terminal  interface 
variables.  WAVESIM  recognizes  two  types  of  terminals:  normal  terminals  having  both 
potential  and  flow  variables,  and  information  terminals  having  only  a  potential  variable.  In 
this  manner,  WAVESIM  can  simulate  processes  involving  both  energy  transfer  and  control 
signals. 

WAVESIM  extends  the  structural  jacobian  matrix  concept  to  reflect  the  properties  of 
the  dependence  of  system  equations  on  system  variables.  The  system  structural  jacobian 
matrix  is  constructed  from  the  constitutive  device  structural  jacobian  matrices  and  is  used  to 
identfiy  a  sequence  of  smaller  blocks  when  can  be  solved  consecutively  for  all  the  system 
variables. 

To  demonstrate  and  verify  the  capabilities  of  WAVESIM,  several  simulations  were 
conducted.  In  all  simulations,  WAVESIM  provide  results  matching  data  generated  by  other 
simulation  methods. 
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Chapter  1  Introduction 

A  revolution  is  occurring  in  modern  warship  design.  The  conventional  mechanical 
transmission  train  for  transferring  power  from  the  prime  movers  to  the  ships  screws  will  be 
replaced  in  future  warship  designs  by  an  integrated  electric  drive  (IED)  system.  While 
electric  drive  is  not  a  new  concept,  the  IED  approach  differs  significantly  from  previous 
electric  drive  implementations  in  that  both  propulsion  power  and  ship  service  power  (60  HZ 
440  Volts  AC)  are  derived  from  the  same  prime  movers.  The  resulting  flexibility  in  the 
arrangability  of  the  ship,  in  the  design  of  the  electric  plant,  and  in  the  power  available  to 
combat  systems  provides  the  naval  architect  with  many  opportunities  for  significantly 
improving  the  combat  effectiveness  of  modern  warships. 

Designing  a  ship  taking  full  advantage  of  the  opportunities  afforded  by  IED  is  not  an 
easy  task  or  even  obvious.  The  ship  designer  has  no  precedent  for  an  IED  ship  let  alone  the 
design  of  an  IED  electric  plant.  Instead,  the  designer  must  rely  heavily  on  simulations  of 
proposed  systems  to  evaluate  the  soundness  of  the  design.  For  the  electrical  power  system,  a 
suitable  simulation  environment  must  be  capable  of  addressing  these  questions: 

Will  the  Electric  Power  System  Work? 

This  is  the  ultimate  question  which  needs  to  be  answered.  Unfortunately  defining 
the  term  work  is  not  an  easy  task,  nor  is  assuring  a  system  will  work  under  all  operating 
conditions.  A  strict  time  domain  simulation  only  provides  a  solution  for  a  given  set  of 
operating  conditions.  Generalizing  the  results  of  relatively  few  simulations  to  all 
operating  conditions  is  both  necessary  and  prone  to  catastrophic  failure.  Hence  more 
than  just  a  time  response  is  usually  needed. 

How  Will  the  System  React  to  Major  Disturbances  and  Faults? 

The  primary  design  goal  for  shipboard  electric  power  systems  is  continuity  of 
power.  To  this  end,  the  response  of  the  system  to  abnormal  events  such  as  grounds, 
stalled  motors,  and  inadvertent  opening  of  breakers  is  crucial  to  evaluating  the  success 
of  the  electric  power  system  design. 

How  Will  the  System  React  to  Severe  Dynamic  Conditions? 

A  number  of  normal  events  can  cause  severe  dynamic  responses  within  the 
system.  Rapidly  changing  the  propulsion  motor  speed  or  direction,  discharging  pulse 
weapons,  or  starting  large  motors  are  all  examples  of  normal  dynamic  events. 
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Is  the  System  Stable  During  a  Given  Dynamic  Scenario? 

One  import  aspect  of  a  system  that  works  is  its  stability.  The  system  should 
remain  stable  during  all  normal  dynamic  conditions  and  for  as  many  disturbances  and 
faults  as  possible. 

What  is  the  Stability  Margin? 

Some  measure  of  how  stable  the  system  is  should  be  provided  to  assist  in 
generalizing  the  findings  of  stability  about  one  scenario  to  other  related  scenarios. 

What  is  the  Sensitivity  of  the  Results  to  Parameters? 

The  generation  of  models  for  a  dynamic  system  simulation  requires  some 
estimation  of  device  parameters.  Knowledge  of  the  sensitivity  of  the  simulation  results 
to  parameter  estimation  errors  is  crucial  for  correlating  simulation  results  with  what  can 
be  expected  from  the  physical  system. 

How  Correct  are  the  Answers  Provided  to  the  Above  Questions? 

Simulations  generally  use  numerical  methods  to  generate  solutions.  Careful 
control  of  error  propagation  is  very  important  in  ensuring  accurate  conclusions  can  be 
drawn  from  the  simulation  results.  Some  form  of  feedback  should  be  provided  to  the 
operator  as  to  the  confidence  level  of  the  results. 

These  requirements  for  performing  time  domain  simulations  of  proposed  and  existing 
electric  power  systems  found  on  United  States  naval  warships  can  be  quite  challenging.  The 
size,  complexity,  and  strong  coupling  of  components  all  conspire  to  make  the  simulator's 
task  difficult.  At  first  glance,  one  would  think  the  simulation  programs  designed  for  the 
commercial  power  utilities  would  be  sufficient  for  handling  the  smaller  shipboard  systems. 
Unfortunately,  this  is  not  the  case  due  to  the  following  differences  of  the  shipboard  system 
from  commercial  power  systems: 

Variable  Frequency 

Frequency  cannot  be  assumed  constant.  Many  IED  designs  have  the  generators, 
motors,  and  ship  service  power  all  operating  at  different  frequencies  to  optimize  the 
performance  of  individual  components.  Frequency  changers  are  employed  to  convert 
the  power  from  one  frequency  to  another.  Even  the  ship  service  system  onboard 
mechanical  drive  ships  can  experience  frequency  fluctuations  lasting  up  to  2  seconds. 
The  limited  rotational  intertia  of  the  prime  movers  and  generators  allows  for  rapid 
accelerations  and  decelerations  of  the  shaft  and  corresponding  frequency  fluctuations. 
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Lack  of  Time  Scale  Separation 

The  principal  time  constants  of  controls,  machine  dynamics,  and  electric 
dynamics  all  fall  within  the  same  general  range  of  milliseconds  to  seconds.  The 
practice  of  decomposing  the  problem  by  time  scale  separation  often  used  in  analyzing 
commercial  power  systems  becomes  much  more  difficult. 

Load  Sharing  instead  of  Power  Scheduling 

The  commercial  power  utilities  operate  by  scheduling  the  power  delivered  by 
each  of  the  generating  units.  The  mismatch  between  scheduled  power  generation  and 
the  actual  load  is  met  by  a  swing  generator.  Onboard  ship  however,  both  real  and 
reactive  power  are  shared  equally  among  all  paralleled  generators  through  the  very  fast 
exchange  of  load  sharing  information.  This  fast  exchange  of  information  strongly 
couples  the  dynamics  of  all  the  paralleled  generators. 

Short  Electrical  Distances 

The  distances  onboard  ship  are  so  short  (under  1000  ft)  as  to  make  the  modelling 
of  transmission  lines  unnecessary  for  most  simulations  and  to  trivialize  the  load  flow 
problem  which  is  so  important  to  the  commercial  power  sector.  The  short  electrical 
distances  also  strengthen  the  coupling  of  the  various  subsystems  making  up  the 
electrical  power  system. 

Load  Dynamics 

Commercial  utilities  usually  assume  loads  are  either  consuming  constant  real  and 
reactive  power,  or  are  constant  impedances.  Shipboard  systems  however,  must  account 
for  dynamics  of  loads  such  as  propulsion  motors,  large  pumps,  pulsed  loads,  propeller 
dynamics,  and  ship  dynamics.  Furthermore,  the  supervisory  level  control  envisioned 
for  future  designs  may  have  the  ability  to  control  aspects  of  the  loads  in  addition  to 
generation. 

Tighter  Control 

Because  a  ship  is  relatively  small,  a  higher  level  of  control  can  be  exercised  over 
the  shipboard  power  system  than  can  be  exercised  in  the  commercial  power  industry. 
This  higher  level  of  control  strengthens  the  dynamic  coupling  of  components  of  the 
system  and  complicates  simulation  efforts. 

Clearly,  shipboard  systems  are  considerably  different  from  commercial  power  systems; 
and  the  inapplicability  to  shipboard  power  systems  of  simulation  techniques  developed  for 
commercial  systems  should  not  be  surprising.    Other  simulation  tools  exist  but  for  one  or 
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more  reasons,  all  are  ill-suited  for  simulating  shipboard  systems.  A  review  of  currently 
available  commercial  software  for  solving  lumped  parameter  systems  reveals  no  program 
currenry  exists  suitable  for  fulfilling  the  needs  of  simulating  shipboard  electric  power 
systems. 

Circuit  Simulators 

As  will  be  discussed  in  following  sections,  circuit  simulators  almost  universally 
describe  devices  in  terms  of  branch  voltages  and  currents.  The  constitutive 
relationships  are  based  only  on  the  relative  difference  of  the  terminal  variables  and  can 
not  depend  on  the  actual  nodal  potentials.  Furthermore,  the  flow  variables  must  be 
conserved  on  the  device  level.  While  these  restrictions  are  not  of  concern  for  electrical 
networks,  they  are  a  bit  constraining  on  electro-mechanical  systems  where  one  would 
like  to  deal  with  energy  transformations  in  a  device  by  employing  equations  which  do 
not  conserve  the  flow  variable  on  the  device  level.  The  torque  on  the  input  shaft  of  a 
gearbox  for  example,  does  not  equal  the  torque  on  the  output  shaft.  Even  electric 
power  models  where  the  flow  variable  is  power  and  the  potential  variable  is  voltage  can 
best  be  described  by  constitutive  equation  which  do  not  enforce  conserving  power  by 
ignoring  the  power  converted  to  heat  through  resistive  losses. 

Many  circuit  simulator  also  have  problems  modelling  the  transfer  of  information 
which  is  common  in  systems  employing  control  systems.  Information  has  only 
potentials  and  no  flows  associated  with  it. 

Signal  Analysis  Software 

Signal  Analysis  Software  is  often  used  to  simulate  control  systems  but  often  have 
difficulty  simulating  energy  transfer.  In  particular,  these  programs  often  are  incapable 
of  solving  implicit  equations  which  are  typically  created  by  writing  Kirchhoff 's  Current 
Law  when  developing  systems.  Instead  much  effort  must  be  expended  to  ensure  the 
models  have  the  appropriate  input  and  output  variables  for  a  given  system  to  be  built. 

Commercial  Power  Utility  Analysis  Programs 

Software  for  analyzing  commercial  power  universally  do  not  apply  to  shipboard 
systems  due  to  several  key  differences.  The  lack  of  transmission  lines,  rotational 
inertia,  time  scale  separation  of  dynamics  and  the  presence  of  tightly  coupled  control 
loops  are  all  features  of  the  shipboard  system  which  prevent  the  use  of  the  commercial 
power  system  analysis  techniques  [5]  [9]  [10]  [11]. 
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General  Differential  Equation  solvers 

Most  general  differential  equation  solving  programs  cannot  handle  implicit 
equations  very  well.  While  the  development  and  interconnecting  of  models  into 
systems  is  possible,  the  process  can  be  quite  cumbersome  [12]  [13].  Dynamically  stiff 
systems  also  pose  serious  challenges  to  the  general  differential  equation  solvers. 

Hybrid  Computers 

Hybrid  computers  for  studying  electrical  power  systems  can  answer  many  of  the 
desired  questions  for  small  shipboard  systems.  Unfortunately,  hybrid  computers  are 
very  expensive  and  limited  in  the  size  of  problems  which  can  be  addressed.  Presently 
the  only  hybrid  computer  in  the  United  States  suitable  for  shipboard  power  system 
studies  is  located  at  Purdue  University.  While  this  machine  is  capable,  the  needs  of  the 
IED  program  will  require  digital  computer  techniques  for  performing  the  desired 
studies.  [92]  [93]  [94]  [95]  [96] 

As  part  of  an  effort  to  fill  the  need  for  simulating  shipboard  power  systems,  the 
WAVESIM  program  was  specially  created  to  develop  applicable  simulation  techniques. 
Before  discussing  the  numerical  methods  employed  in  WAVESEM,  a  review  of  existing 
methods  is  appropriate. 

1.1  Simulation  Process 

The  process  of  simulating  a  physical  system  can  be  broken  into  three  steps.  First,  a 
system  of  equations  describing  the  component  device  constitutive  relationships  as  well  as 
the  network  constraints  must  be  developed.  While  the  network  constraints  are  purely  linear 
algebraic  equations,  the  constitutive  equations  can  be  nonlinear  and  dynamic.  Together,  a 
system  of  nonlinear  differential  algebraic  equations  is  generated.  The  next  step  is  the 
conversion  of  the  system  of  differential  algebraic  equations  into  a  sequence  of  purely 
algebraic  equations.  Common  integration  techniques  include  the  forward  and  backward 
Euler  methods,  Trapezoidal  rule  integration,  and  the  Runge-Kutta  methods.  Finally,  the 
nonlinear  algebraic  system  is  solved  either  through  the  Newton-Raphson  method  or  through 
one  of  several  relaxation  techniques. 

Before  describing  several  methods  for  generating  and  solving  the  system  of  equations 
corresponding  to  a  physical  system,  the  difference  between  the  branch  description  and 
terminal  description  of  devices  should  be  detailed.  The  branch  description  of  devices 
requires  all  the  constitutive  relationships  be  based  on  the  relative  difference  between 
terminal  potentials  and  all  flows  entering  a  device  also  leave  the  device.    Hence  for  a  two 
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terminal  device,  there  is  a  single  branch  potential  variable  and  a  single  branch  flow  variable 
associated  with  it.  In  the  terminal  description,  the  potential  and  flow  associated  with  each 
terminal  are  variables.  A  two  terminal  device  would  then  have  four  variables  associated 
with  it:  two  flow  variables  and  two  potentials.  The  terminal  description  allows  the 
constitutive  equations  be  a  function  of  the  actual  values  of  the  terminal  potentials  and  not 
only  of  the  potential  difference.  In  other  words,  the  potential  reference  can  be  set  at  the 
system  level  and  not  necessarily  on  the  device  level.  Furthermore,  the  flows  are  not 
required  to  be  conserved.  A  gear  box  for  example,  has  differing  torques  entering  and 
exiting  it.  The  branch  description  method  requires  a  four  terminal  model  of  the  gear  box 
while  the  terminal  description  requires  only  two  terminals.  In  either  case  the  result  would 
be  four  variables  describing  the  gearbox,  but  the  branch  description  requires  an  explicit 
declaration  of  the  device  potential  reference  while  the  terminal  description  uses  an  implicit 
system  wide  potential  reference. 

Branch  Description  vs.  Terminal  Description 


+ 
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1.2  Developing  System  Equations 

The  normal  method  of  describing  a  dynamic  system  is  to  generate  a  consistent  set  of 
possibly  nonlinear  differential  algebraic  equations  and  arrange  them  into  the  following 
canonical  form: 

Cx=f(x,y,u) 
0  =  g(x,y,u) 

where  x  is  the  vector  of  dynamic  state  variables,  y  is  the  vector  of  state  variables  with  no 
associated  dynamics  staes,  and  u  is  the  vector  of  system  inputs.  This  system  of  differential 
algebraic  equations  (DAE)  can  be  generated  several  different  ways  with  the  most  common 
being  the  Sparse  Tableu,  Modified  Nodal  Analysis,  and  the  standard  load  flow  method. 

The  method  employed  in  WAVESIM  does  not  extract  the  differential  equations  from 
the  device  constitutive  equations  but  instead  forms  a  system  of  algebraic  equations  of  the 
form: 

0  =  g(x,gi(xl,ui),u) 

where  x  is  the  vector  of  the  system  variables  and  g,()  is  a  device  function  having  subsets  *, 
and 

of  x  and  u  as  arguments.    The  functions  g,{)  have  the  dynamics  of  the  device  contained 
within  them,  but  these  dynamics  are  not  expressed  on  the  system  level. 
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1.2.1  Sparse  Tableau  Method 

The  Sparse  Tableau  method  is  a  very  general  method  for  describing  systems 
employing  the  branch  description  of  devices.  Proposed  in  [4]  and  used  in  the  ASTAP  and 
SPICE  simulators  [1][15][16],  the  Sparse  Tableau  method  breaks  the  system  equations  and 
variables  each  into  three  groups.  The  three  sets  of  variables  are  the  branch  currents,  branch 
voltages,  and  the  nodal  voltages.  The  three  sets  of  equations  are  the  node  Kirchhoff 
Current  Law  (KCL)  equations  in  terms  of  the  branch  currents,  Branch  Voltage  equations 
relating  branch  voltages  to  nodal  voltages,  and  the  Constitutive  equations  relating  branch 
voltages  to  branch  currents. 

Figure  1.2.1-1  RC  Example:  Sparse  Tableau 


Figure  1.2.1-1  shows  an  example  of  a  simple  RC  charging  circuit.   Using  the  Sparse 
Tableau  approach,  the  system  variables  are: 


in 

ic 

ei 
e2 


Voltage  Source  branch  current 
Resistor  branch  current 
Capacitor  branch  current 

Voltage  Source  branch  voltage 
Resistor  branch  voltage 
Capacitor  branch  voltage 


Node  1  potential  (voltage) 
Node  2  potential  (voltage) 

Note  the  reference  node  0  is  assigned  a  potential  of  0. 
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The  KCL  equations  are  given  by: 

is  +  h  =  0  ~h  +  k  =  ° 

The  Branch  Voltage  equations  are: 

vs  -et  =  0  vc  -  e2  =  0 

VR  ~  (*1  -  «2>  =  ° 

The  Constitutive  equations  are: 

vs-^5  =  0  .  dvc 

lc-C-di  =  ° 
vR-iRR=0 

While  the  Sparse  Tableau  approach  generates  a  consistent  set  of  network  equations, 
the  size  of  the  system  is  relatively  large  (eight  equations  in  eight  unknowns  for  this 
example).  Furthermore,  the  method  employs  the  branch  description  of  devices  which 
complicates  the  development  of  electro-mechanical  models. 
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1.2.2  Modified  Nodal  Analysis 


The  Modified  Nodal  Analysis  method  generates  a  compact  set  of  system  equations 
for  systems  of  device  models  using  branch  descriptions.  Modified  Nodal  Analysis  (MNA) 
was  formalized  in  [6],  described  in  [1][16],  and  employed  in  the  circuit  simulator  MSINC. 
The  procedure  consists  of  writing  the  KCL  equations  for  all  but  the  reference  node  in  terms 
of  the  branch  currents,  replacing  the  branch  currents  wherever  possible  with  constitutive 
equations  in  terms  of  the  branch  voltages,  appending  any  remaining  constitutive  equations, 
and  substituting  the  branch  voltages  with  the  corresponding  nodal  voltages. 

Figure  1.2.2-1  RC  Example:  Modified  Nodal  Analysis 


+    V 


Figure  1.2.2-1  shows  a  simple  example  of  a  simple  RC  charging  circuit,  the  MDA 
approach  would  first  write  the  KCL  equations: 


is  +  iK  =  0 


-iR  +  ic  =  0 


Substituting  the  constitutive  relations  results  in: 


is+KV*  =  0 


1  d\c 

R  *         dt 


The  extra  constitutive  equation  is  given  by: 


vs-Vs  =  0 
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Substituting  the  nodal  voltage  results  in  the  system  of  three  equations 
1  ,  x     ~  1  de2 


While  the  Modified  Nodal  Analysis  Method  generates  a  compact  set  of  equations,  it 
does  require  the  use  of  the  branch  description  as  well  as  the  explicit  definition  of  flow 
variables.  Both  restrictions  can  complicate  teh  modelling  of  electro-mechancial  devices. 
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1.2.3  Standard  Load  Flow 

The  Load  Flow  approach  is  traditionally  used  in  the  analysis  of  commercial  power 
systems.  For  this  application,  the  flow  variables  are  usually  real  and  reactive  power  while 
the  potential  variables  are  the  voltage  magnitude  and  phase  angle.  The  Load  Flow 
approach  is  a  variation  of  nodal  analysis  described  in  many  papers  and  texts  on  power 
systems  including  [14]  [29]  [31]  [35]  [49]  [50]  [76]  [101].  The  terminal  description  of 
devices  is  used  since  power  flow  is  not  conserved  on  the  device  level  (The  power  entering 
a  transmission  line  is  not  the  same  as  the  power  leaving  the  same  line).  The  basic 
procedure  is  to  write  the  KCL  equations  in  terms  of  the  node  potentials.  Nodes  with  ideal 
potential  sources  are  treated  specially  since  their  corresponding  flow  variable  is  not  a 
function  of  the  device  voltages. 

Figure  1.2.3-1  RC  Example  :  Load  Flow 


Figure  1.2.3-1  shows  a  simple  RC  charging  circuit  using  the  terminal  description  of 
the  devices.  A  load  flow  approach  using  currents  as  the  flow  variable  would  result  in  the 
following  procedure: 

Write  the  KCL  Equation  at  nodes  without  potential  sources 


Substitute  Constitutive  relationships  for  the  flow  variables 


R 


(vR2-vR1)  +  C 


dt 


=  0 
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Substiute  the  nodal  potentials 


1  de2 


All  the  remaining  variables  can  be  calculated  from  the  solution  of  this  differential 
equations.  The  load  flow  method  definitely  creates  a  very  compact  set  of  equations  (only 
one  in  this  case)  but  requires  the  flow  variables  be  defined  explicitly  in  terms  of  the 
potential  variables,  and  must  treat  ideal  potential  sources  as  special  exceptions.  Neither  of 
these  restrictions  is  attractive  for  a  general  electro-mechanical  system  simulator. 
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1.2.4  WAVESIM  Terminal  Description 

The  method  employed  in  this  thesis  is  similar  to  Modified  Nodal  Analysis  with  the 
exception  that  terminal  potentials  are  used  instead  of  branch  voltages  and  that  the 
constitutive  equations  are  only  expressed  on  the  device  level  and  never  expressed  on  the 
system  level.  Potential  difference  equations  are  appendended  to  the  system  of  KCL 
equations  to  equate  explicitly  defined  potentials  with  their  node  potentials.  For  the  RC 
example,  the  system  variables  are  given  by: 

iSI  Voltage  Source  terminal  1  current 

icl  Capacitor  terminal  1  current 

e0  Node  0  potential  (voltage 

et  Node  1  potential  (voltage) 

e2  Node  2  potential  (voltage) 

Figure  1.2.4-1:  RC  Example:  Terminal  Description 

lRl  R 


The  KCL  Equations  for  the  RC  example  are  given  by: 

fel+fiUJu(«l.«2)  =  0 
k/+&JR2(«l.«2)  =  0 

h  +  Ss  32  (hj »  eo)  +  Sc  ,C2  (*ci  >eo)  =  0 
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The  Potential  Difference  Equations  are  given  by: 

e2  ~  Sc_vCl  C'o '  co)  =  ^ 

ei-&_v57fe»*o)  =  0 

Note  that  a  reference  device  allowing  for  a  more  general  method  of  setting  the 
system  reference  points  is  employed  rather  than  a  reference  node.  While  the  number  of 
equations  is  twice  that  of  the  Modified  Nodal  Analysis  method,  flows  need  not  be 
conserved  on  the  device  level.  Furthermore,  the  system  of  equations  is  easily  partitioned 
into  a  sequence  of  five  blocks  for  a  more  rapid  solution  (two  lxl  blocks,  followed  by  a 
2x2  block,  followed  by  two  more  lxl  blocks). 
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1.3  Solving  System  Equations 

As  stated  earlier,  the  standard  approach  to  simulating  a  physical  system  is  to  generate 
a  system  of  differential  algebraic  equation  of  the  form: 

Cx=f(x,y,u) 
0  =  g(x,y,u) 

To  solve  this  system,  it  must  first  be  converted  to  a  system  of  purely  algebraic 
equations  by  substituting  the  differential  equations  with  discrete  approximations.  The  time 
history  of  a  variable  is  expressed  as  a  series  of  discrete  points  in  time  where  dynamics  are 
expressed  as  algebraic  relationships  between  the  values  of  a  variable  at  different  discrete 
times.  Standard  methods  for  performing  this  approximation  include  the  forward  and 
backward  Euler,  Trapezoidal  rule  integration  and  Runge-Kutta  methods. 

The  major  problem  with  this  approach  is  the  dependence  of  the  time  step  on  the  fastest 
mode  (smallest  eigenvalue)  of  the  dynamic  system.  This  forces  the  entire  system  be  solved 
with  a  very  fine  discretization  of  time,  even  though  large  portions  of  the  system  are  not 
affected  by  the  fast  mode. 

In  any  case,  the  system  of  nonlinear  algebraic  equations  must  be  solved.  The  two 
classes  of  solvers  most  commonly  used  are  variations  of  the  Newton-Raphson  Method  and 
several  relaxation  methods. 

1.3.1  Newton-Raphson  Method 

The  Newton-Raphson  method  works  well  for  most  systems  as  long  as  the  initial 
guess  for  all  of  the  variables  are  within  the  convergence  region  of  the  final  solution.  This 
method  is  used  in  SPICE  and  ASTAP  and  is  based  on  a  Taylor  series  expansion  of  the 
system  of  equations: 

F(x)  =  0  =  F(xk)+J(xk)Ak  +  ... 

xk  +  l=xk  +  Ak 

Ak  =  -T\xk)F(xk) 

The  matrix  J  is  called  the  Jacobian  Matrix  and  its  inverse  must  exist  for  the 
method  to  work. 
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1.3.2  Relaxation 

Relaxation  methods  assign  one  of  the  system  variables  to  each  of  the  system 
equations.  After  initial  guesses  are  made  for  each  of  the  variables,  the  variables  are 
updated  by  solving  their  corresponding  equation  assuming  none  of  the  other  variables  have 
changed.  The  two  most  popular  relaxation  methods  are  the  Gauss-Jacobi  (popular  with 
parallel  processing  computers)  and  the  Gauss-Seidel  method  (usually  used  with  serial 
processing  computers).  The  Gauss-Jacobia  calculates  updates  for  all  the  system  variables 
before  actually  performing  the  update: 

F(*)  =  0 

The  Gauss-Seidel  method  updates  the  system  variables  as  the  updates  are  calculated: 

F(3c)  =  0 

1.3.3  Waveform  Relaxation 

An  alternate  method  to  solving  the  dynamic  equations  system  wide  is  to  solve  them 
equation  by  equation  over  a  given  time  interval.  The  Waveform  Relaxation  method 
represents  variables  by  a  sequence  of  points  representing  the  time  history  of  the  waveform 
over  a  given  time  interval.  Each  variable  can  be  discretized  differently  and  is  assigned  one 
of  the  system  equations.  The  system  equations  are  solved  over  the  waveform  interval  for 
their  assigned  variable  with  the  other  variables  held  at  their  current  waveform  values. 

Waveform  Relaxation  works  well  with  loosely  or  directionally  coupled  systems,  but 
does  not  work  well  for  tightly  coupled  systems.  The  method  does  however,  have  good 
multirate  performance  since  each  differential  equation  can  be  solved  using  a  time 
increment  appropriate  to  it. 

1.3.4  WAVESIM  Approach 

To  summarize  the  traditional  solving  methods,  the  standard  methods  employing 
Netwon-Raphson  can  handle  tightly  coupled  systems  but  perform  poorly  with  multirate 
systems  while  waveform  relaxation  performs  poorly  with  tightly  coupled  systems  but 
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efficiently  solves  multirate  problems.  Unfortunately,  the  shipboard  systems  have  both 
multirate  and  tightly  coupled  properties.  For  this  reason,  WAVESEM  combines  the 
Newton-Raphson  method  with  a  waveform  representation  of  variables. 

In  WAVESIM  variables  are  represented  over  a  time  interval  by  a  vector  of 
coefficients  along  with  a  type  indicator  for  specifying  how  the  coefficients  should  be 
interpreted.  Common  interpretations  include  Legendre  Series  coefficients,  Chebyshev 
Series  coefficients,  and  polynomial  series  coefficients.  For  these  representations, 
integration  and  differentiation  are  linear  matrix  operations  and  the  issue  of  numerical 
stability  of  an  integration  technique  disappears.  Waveforms  can  usually  be  converted 
from  one  type  to  another  with  a  linear  matrix  operation  as  well. 

With  variables  represented  as  vectors  of  coefficients,  the  Newton-Raphson  method 
can  be  employed  for  solving  tightly  coupled  systems.  Good  multirate  performance  is 
achieved  through  the  linear  matrix  operator  for  integration  along  with  waveform 
smoothing  to  average  out  phenomena  faster  than  the  time  scale  of  interest. 

1.4  Thesis  Outline 

This  thesis  focuses  on  developing  a  digital  computer  simulation  environment  suitable 
for  studying  shipboard  electric  power  systems.  WAVESIM,  a  simulation  program  written 
in  the  C  programming  language  demonstrates  algorithms  for  simulating  systems  of 
nonlinear  lumped  parameter  models  representing  the  electro-mechanical  components 
composing  an  IED  system.  The  key  features  of  WAVESIM  are: 

Devices  defined  independent  of  the  encompassing  systems 

Devices  can  be  developed  and  tested  without  an  exact  knowledge  of  the 
topology  of  the  systems  incorporating  the  devices. 

Devices  described  using  the  Terminal  Representation  of  devices 

Device  constitutive  relationships  are  written  in  terms  of  the  actual  values  of  the 
terminal  potentials  and  not  in  terms  of  relative  potentials.  In  this  manner,  device 
equations  can  be  written  in  terms  of  a  system  reference  when  such  a  reference  level  is 
unambiguous.  Furthermore,  the  flow  variables  are  not  required  to  be  conserved  on  a 
device  level.  This  greatly  eases  the  task  of  modelling  flows  which  also  depend  on  a 
reference  potential  (power  for  example). 
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Devices  defined  independent  of  the  manner  in  which  terminal  interface  variables 
are  expressed. 

Devices  can  be  developed  without  specifying  how  the  interface  variables  are 
specified.  In  WAVESIM,  variables  can  be  represented  many  different  ways,  all  of 
which  are  irrelevant  to  the  specification  of  the  constitutive  equations  making  up  the 
device. 

System  equations  instead  of  the  devices  resolve  input-output  conflicts. 

WAVESIM  does  not  constrain  normal  terminals  where  energy  is  transferred 
from  having  more  than  one  output  hooked  together  at  a  node. 

Interface  Variables  represented  by  waveforms 

Waveforms  are  a  vector  of  coefficients  which  specif)'  a  given  variable  over  a 
given  time  interval  instead  of  a  single  value  describing  the  variable  at  a  given  point  in 
time.  The  waveform  type  determines  how  the  coefficients  should  be  interpreted  for 
generating  values  of  the  variable  within  the  time  interval.  Representing  variables  as 
waveforms  has  the  primary  benefit  of  removing  the  issue  of  numerical  stability  of 
integration  techniques  from  the  simulation.  Integration  and  differentiation  are  merely 
operators  on  waveforms,  no  different  from  addition,  subtraction,  or  any  of  the 
trigonometric  operators. 

Differentiation  and  Integration  performed  on  the  device  level  instead  of  the 
system  level. 

Most  circuit  simulators  as  described  in  the  previous  sections  solve  the 
differential  equations  associated  with  device  constitutive  equations  on  a  system  level. 
This  method  eases  the  task  of  evaluating  the  stability  of  linear  systems  but  introduces 
new  problems.  If  the  eigenvalues  of  a  dynamic  system  are  widely  separated  in  value, 
the  simulation  time  step  must  be  made  very  small  for  the  entire  system  if  conventional 
integration  techniques  are  employed.  WAVESIM  solves  the  differential  equations  on 
the  device  level  and  employs  waveform  smoothing  to  remove  dynamics  which  occur 
faster  than  the  time  scale  of  interest. 

While  many  of  the  pieces  of  WAVESIM  are  not  new,  several  key  concepts  are 
presented  in  this  thesis  for  the  first  time: 

The  Terminal  Description  of  devices 

Instead  of  specifying  the  interface  of  devices  by  ports  consisting  of  a  potential 
difference  (branch  voltage)  and  the  flow  through  the  potential  difference  (branch 
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current),  the  terminal  description  of  a  device  assigns  a  potential  and  a  flow  entering 
the  device  for  each  normal  terminal.  Simulators  based  on  branch  voltages  and 
currents  require  all  of  the  flow  entering  a  device  to  also  leave  the  device.  In  this 
sense,  the  flow  is  conserved.  The  terminal  description  however,  does  not  require 
conservation  of  flow  within  a  device  (Conservation  of  flow  as  expressed  by 
Kirchhoff's  Current  Law  -  KCL  is  required  at  connection  points  called  nodes).  The 
ability  to  construct  models  which  do  not  conserve  flows  can  simplify  models  where 
energy  transformations  occur,  the  reference  potential  is  clearly  known  for  the  system 
and  not  just  for  the  device,  and  certain  forms  of  energy  are  not  of  interest.  In  many 
mechanical  simulations  for  example,  the  amount  of  energy  lost  in  friction  is  not  of 
interest  to  the  modeler.  A  simulation  model  based  on  branch  potentials  and  flows  of  a 
device  experiencing  friction  would  be  required  to  reject  the  frictional  heat  through  one 
of  its  branches. 

The  terminal  description  also  allows  for  the  transfer  of  information  between 
devices  through  information  nodes  and  information  terminals.  This  feature  is 
essential  for  successfully  modelling  many  control  algorithms.  The  ability  to  mix 
control  signals  and  energy  transfer  through  flow  variables  within  the  same  simulation 
environment  is  a  major  advantage  of  the  terminal  description. 

The  Structural  Jacobian  method  for  building  and  reducing  systems 

The  concept  of  the  connection  matrix  for  specifying  the  participation  of  system 
variables  in  system  equations  is  expanded  to  include  the  structural  form  (i.e.  diagonal, 
linear,  nonlinear,  etc.)  of  the  dependence  of  the  system  equations  on  the  system 
variables.  The  codes  for  the  structural  Jacobian  adhere  to  a  simple  set  of  algebraic 
rules  which  can  be  used  to  construct  a  system  structural  Jacobian  matrix  from  the 
individual  device  structural  Jacobians.  The  system  structural  Jacobian  facilitates  the 
reduction  of  the  numerical  effort  required  to  solve  the  system  by  identifying  and 
characterizing  a  set  of  smaller  blocks  which  when  sequentially  solved,  determine  all 
of  the  system  variables.  The  system  structural  Jacobian  can  also  be  used  to  detect 
unconnected  systems  and  indicate  possible  potential  reference  problems. 

The  Systematic  Treatment  of  Waveforms  as  an  abstract  data  type 

WAVESIM  departs  from  the  conventional  paradigm  of  representing  variables  in 
a  dynamic  simulation  by  a  series  of  discrete  points  in  time  with  a  new  paradigm  based 
on  representing  variables  as  a  sequence  of  waveform  intervals.  Within  each 
waveform  interval,  the  value  of  the  waveform  can  be  directly  determined  for  any  time 
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based  on  a  vector  of  coefficients,  a  waveform  type  indicator  for  specifying  how  the 
vector  of  coefficients  should  be  interpreted,  and  the  time  boundaries  of  the  waveform 
interval.  Devices  are  defined  independent  of  the  waveform  type  of  the  terminal 
variables.  The  principle  advantage  of  using  waveforms  is  that  integration  and 
differentiation  are  simple  operators.  The  integral  of  a  waveform  is  just  another 
waveform.  Simulation  time  steps  are  no  longer  controlled  by  the  requirement  for 
numerical  stability  of  the  integration  technique.  Instead,  series  truncation  error 
control  becomes  the  primary  concern  of  the  simulation  environment.  The  ability  to 
use  arbitrary  waveform  types  and  convert  between  types  allows  the  modeler  to  use  the 
most  appropriate  waveform  representation  for  the  modeling  problem. 

This  thesis  is  composed  of  six  chapters  including  this  introduction.  Chapter  Two 
describes  in  some  detail  the  specific  properties  of  current  shipboard  electric  power  systems 
and  proposed  integrated  electric  drive  systems.  Chapter  Three  provides  a  framework  of 
theory  for  developing  the  simulation  environment  WAVESIM  and  is  broken  into  five 
subsections.  The  first  subsection  details  the  Terminal  Description  method  for  modelling 
devices.  The  second  subsection  demonstrates  how  to  interconnect  device  models  into 
systems,  construct  the  system  structural  Jacobian,  and  generate  a  sequence  of  blocks  for 
solving  the  system  equations.  The  third  subsection  covers  the  treatment  of  waveforms  as  an 
abstract  data  type.  Solving  the  system  of  equations  employing  waveforms  is  detailed  in  the 
fourth  subsection.  The  fifth  and  final  subsection  of  the  third  chapter  covers  modelling 
techniques  and  considerations  not  covered  in  previous  sections.  The  actual  WAVESIM 
implementation  of  the  concepts  developed  in  the  third  chapter  are  described  in  the  fourth 
chapter.  The  fifth  chapter  presents  results  of  several  simulations  conducted  with 
WAVESIM.  The  final  chapter  provides  an  assessment  of  the  work  presented  here  as  well  as 
possible  future  developments. 

The  appendices  support  the  main  chapters.  Appendix  A  is  a  glossary  of  terms  used 
through  out  this  thesis.  Appendix  B  details  some  possible  problems  with  using  continuation 
parameters.  Appendices  C  and  D  are  Load  Flow  examples  of  the  terminal  description 
method.  Appendix  E  provides  examples  of  waveform  types  and  a  number  of  operators  for 
them.  Appendix  F  presents  a  number  of  models  useful  for  conducting  shipboard  power 
system  simulations.  Finally,  Appendix  G  details  the  program  files  making  up  WAVESIM. 

This  thesis  introduces  a  number  of  new  terms.  To  assist  the  reader,  the  fust  occurance 
of  a  new  term  is  indicated  by  the  distinctive  Helvetica  typeface.  MATLAB  variable  names 
and  sample  sections  of  C  programs  are  printed  in  Courier. 
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Chapter  2  Shipboard  Electric  Systems 
2.1  Typical  Shipboard  Electric  Distribution  System 

The  electric  power  systems  onboard  naval  warships  differ  considerably  from  the 
integrated  power  utilities  found  in  developed  countries.  The  differences  arise  from  the 
small  size  of  the  shipboard  systems  and  contrasting  standards  for  optimization.  Shipboard 
systems  are  optimized  for  survivability  and  minimization  of  weight  and  volume.  Power 
utilities  on  the  other  hand  optimize  for  reliability  and  minimization  of  cost.  The  unique 
characteristics  of  the  shipboard  systems  result  in  markedly  different  design  requirements 
and  standards  as  compared  to  power  utilities. 

Frigates,  destroyers  and  cruisers  are  relatively  small  warships  with  corresponding 
small  electric  power  systems.  Frigates  normally  displace  from  2000  to  4000  long  tons 
(1  long  ton  =  2240  lbs)  and  have  a  primary  mission  of  escorting  merchant  convoys.  In  the 
U.S.  Navy,  frigates  have  only  one  propulsion  shaft  and  about  half  the  armament  of  a 
destroyer.  Destroyers  displace  from  4000  to  7500  long  tons  and  are  designed  as  escorts  for 
aircraft  carrier  battle  groups.  Cruisers  are  larger  than  destroyers,  displacing  from  6000  to 
16000  long  tons,  carry  more  weapons,  and  are  used  to  provide  aircraft  carrier  battle  groups 
with  integrated  anti-aircraft  and  anti-cruise  missile  defenses.  U.S.  Navy  cruisers  and 
destroyers  all  have  two  propulsion  shafts. 

The  installed  electric  plant  capacity  for  U.S.  warships  has  varied  from  3000  KW  to 
4500  KW  per  propulsion  shaft  over  the  past  twenty  years.  Generally,  the  newer  ships  have 
more  installed  capacity.  Figure  2.1-1  shows  the  electric  plant  characteristics  for  the  major 
classes  of  conventionally  fueled  frigates,  destroyers  and  cruisers  constructed  in  the  past 
twenty  years.  All  the  listed  ships  with  the  exception  of  the  Knox  class  frigates  use 
mechanically  coupled  gas  turbine  propulsion.  The  Knox  class  frigate  is  the  last  class  of 
conventionally  fueled  warships  to  use  1200  psi  steam  for  main  propulsion.  (All  nuclear 
powered  ships  use  600  psi  steam).  Most  of  the  Knox  class  frigates  are  presently  being 
transferred  to  the  reserve  forces  or  being  decommissioned. 
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Figure  2.1-1  U.S.  Navy  Ship  Characteristics 

Ship  Class  (Nbr) 

Name 

KW 

Generator  Type 

Year 

FF-1052  Frigate 
(46) 

Knox 

4  x  750  KW 

3  Steam  Turbine 
1  Diesel 

1969 

FFG-7  Frigate 
(51) 

Oliver  Hazard 
Perry 

4x  1000 
KW 

4  Diesel 

1977 

DD-963  Destroyer 
(31) 

Spruance 

3  x  2000 
KW 

3  Gas  Turbine 

1975 

DDG-993  Destroyer 
(4) 

Kidd 

3  x  2000 
KW 

3  Gas  Turbine 

1981 

DDG-51  Destroyer 
(1  +  28) 

Arleigh  Burke 

3  x  3000 
KW 

3  Gas  Turbine 

1991 

CG-47  Cruiser 
(19  +  8) 

Ticonderoga 
"Aegis" 

3  x  2500 
KW 

3  Gas  Turbine 

1983 

Figure  2.1-2  Shipboard  Electric  Distribution  System 
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Figure  2.1-2  shows  a  typical  ring  bus  architecture  found  on  modern  warships.  The 
small  size  of  the  shipboard  system  results  in  many  differences  with  respect  to  commercial 
systems.  As  a  consequence  the  analysis  of  the  shipboard  plant  requires  recognition  of  these 
differences: 

1.  Power  Quality  requirements  relaxed  relative  to  commercial 

standards.  Constant  frequency  and  voltage  assumptions 
can  not  be  made.  See  section  2.2  for  more  details. 

2.  Very  little  Rotational  Inertia  require  fast  controls  to 

maintain  frequency.  Infinite  bus  assumption  does  not  hold. 

3.  Transmission  lines  are  very  short  and  for  the  most  studies, 

can  be  ignored. 

4.  No  scheduling  of  real  or  reactive  power.  All  generators 

are  loaded  in  equal  proportion  to  their  rating. 
Load  Flow  solution  has  little  meaning. 

5.  Load  sharing  information  communicated  to  all  online  generators. 

6.  Large  loads  (relative  to  the  size  of  generation  plant)  present. 

Start  up  transients  (load  dynamics)  are  important. 

7.  Power  Electronic  Switching  loads  are  significant. 

8.  Load  shedding  strategies  are  minimal. 

Figure  2.1-2  also  indicates  the  requirement  for  a  simulation  environment  to  include 
the  ability  to  model  more  than  just  electric  power  phenomena.  Modelling  shipboard 
systems  also  requires  extensive  representation  of  mechanical  dynamics  as  well  as  energyless 
information  transfer  between  components.  This  requirement  is  significant  in  that  simulation 
packages  for  commercial  power  systems  do  not  include  this  capability  as  an  integral  part  of 
the  simulation  environment  design. 

2.2  Shipboard  Electric  Plant  Standards 

The  primary  standards  for  designing  a  shipboard  electric  plant  are  contained  in  the 
following  references: 

Department  of  Defense,  Interface  Standard  for  Shipboard  Systems,  Section  300A, 
Electric  Power,  Alternating  Current  (Metric),  MIL-STD-1399(NAVY),  13 
October  1987. 
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Department  of  the  Navy,  General  Specifications  for  Ships  of  the  United  States  Navy, 
Section  300,  General  Requirements  for  Electric  Plant,  Naval  Sea  Systems 
Command,  1987. 

Department  of  the  Navy,  General  Specifications  for  Ships  of  the  United  States  Navy, 
Section  320,  General  Requirements  for  Electric  Power  Distribution  Systems, 

Naval  Sea  Systems  Command,  1987 

The  goal  of  electric  power  utilities  is  to  provide  a  reliable  source  of  high  quality 
electric  power  at  minimum  cost.  Shipboard  systems  on  the  other  hand  are  designed  to 
provide  a  survivable  and  continuous  source  of  electricity.  Quality  and  cost  are  secondary 
issues.  Figure  2.2-1  summarizes  the  minimum  quality  of  power  a  shipboard  system  must 
provide 

Figure  2.2-1  clearly  demonstrates  the  quality  of  power  guaranteed  onboard  a  warship 
is  considerably  lower  than  the  quality  of  service  provided  by  power  utilities.  Figure  2.2-1 
does  not  show  however,  how  often  the  transient  conditions  occur.  This  information  is 
provided  by  MIL-STD-1399  and  summarized  in  figure  2.2-2.  A  major  ramification  of  the 
low  quality  of  power  provided  by  the  ship  service  electric  system  is  that  loads  must  be 
designed  to  operate  and  survive  wide  ranges  of  voltage  and  frequency  fluctuations.  This  is 
one  of  the  reasons  why  commercial  equipment  often  can  not  be  directly  installed  onboard 
ships  (Shock  requirements  are  also  a  major  factor).  Sensitive  loads  must  provide  their  own 
filtering  and  protection  circuitry.  This  militarization  of  equipment  can  add  considerable 
cost  and  complexity  to  warship  design,  outfitting  and  maintenance. 


34- 


Figure  2.2-1  :  Shipboard  Electric  Power  Quality  Standards  (MIL-STD-1399) 

Frequency 

Nominal 

60  Hz 

Tolerance 

±3% 

Modulation1 

0.5% 

Transient  Tolerance 

±4% 

Transient  Recover  Time 

2  seconds 

Worst  Case  Excursion 

±  5.5  % 

Voltage 

Nominal 

440/1 15  Volts 

Tolerance  of  3  Phase  Ave 

±5% 

Tolerance  of  any  1  Phase 

±7% 

Line  Voltage  Unbalance2 

3% 

Voltage  Modulation 

2% 

Transient  Tolerance 

±16% 

Maximum  Departure  Voltage  from 

±6% 

combination  of  3  Phase  Ave.  and 

Voltage  Modulation 

Worst  Case  Excursion 

±20% 

Recovery  Time 

2  Seconds 

Voltage  Spike3 

2500/ 1000  Volts 

Voltage  Waveform 

Max  Total  Harmonic  Distortion4 

3% 

Max  Single  Harmonic 

2% 

Max  Deviation  Factor5 

5% 

Emergency 

Frequency  Excursion 

-100%  to +12% 

Voltage  Excursion 

-100%  to +35% 

Duration 

2  Minutes 

1  Modulation  (percent)  = 


IE. 


100  measured  over  a  period  of  1  to  10  seconds. 


2  Line  Voltage  Unbalance  is  the  difference  between  the  largest  line  to  line  voltage  and  the 
smallest  line  to  line  voltage  divided  by  the  nominal  voltage. 

3  A  Voltage  Spike  is  a  voltage  change  of  less  than  1  ms  duration. 

4  Total  Harmonic  distortion  is  the  ratio  of  the  rms  value  of  the  residue  (after  elimination  of 
the  fundamental)  to  the  rms  value  of  the  fundamental. 

5  Deviation  Factor  is  the  ratio  of  the  maximum  difference  between  corresponding  ordinates 
of  the  waveform  and  an  equivalent  sine  wave  to  the  magnitude  of  the  equivalent  sine  wave. 
The  equivalent  sine  wave  is  defined  as  having  the  same  frequency  and  rms  voltage  as  the 
wave  being  tested. 
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Figure  2.2-2  Shipboard  Electrical  Reliability 


Voltage  Transients  of  10%  or  less 

Voltage  Transients  of  10%  to  16% 

Voltage  Spikes  above  200  Volts 


Several  times  an  hour 

Several  times  a  day 

About  once  every  3  hours 


The  basic  reason  for  the  low  quality  of  power  onboard  ship  is  the  lack  of  rotational 
inertia  in  the  power  system.  In  the  commercial  sector,  the  inertia  of  all  the  generators  in  the 
network  add  up  to  such  a  large  number  that  no  single  fault  can  cause  a  frequency 
disturbance  system  wide.  Onboard  ship  however,  generators  are  often  operated 
independently.  Other  than  the  inertia  provided  by  motors,  the  only  source  of  rotational 
inertia  is  the  one  generator.  Since  the  generators  are  not  very  large,  sudden  load  changes 
and  faults  can  cause  significant  disturbances.  Although  speed  governors  and  voltage 
regulators  have  improved  significantly  in  the  past  twenty  years,  there  is  presently  no  way  to 
prevent  the  transients  from  happening. 

The  frequency  tolerance  limits  in  the  steady  state  are  rarely  ever  approached  in 
modern  warships.  The  rather  loose  tolerances  allowed  the  use  of  droop  governors  to  stably 
share  loads.  The  electric  plant  operator  on  older  ships  could  increase  the  load  on  a 
paralleled  generator  by  increasing  the  base  frequency  set  point  on  the  mechanical  speed 
governor.  Adjusting  the  system  frequency  without  changing  the  load  sharing  ratios  required 
adjusting  the  base  frequency  set  points  on  all  the  generator  speed  governors.  On  modern 
warships,  all  the  generators  normally  operate  isosynchronously  and  perform  load  sharing  by 
transmitting  load  current  information  to  Governor  Control  Units  which  provide  feedback  to 
the  isosynchronous  governors. 

2.3  Shipboard  Electric  Plant  Design 

In  the  commercial  sector,  the  design  of  electric  generation  and  transmission  capacity 
are  done  continuously.  Ships  on  the  other  hand,  have  a  finite  life  (typically  thirty  years)  and 
the  expense  of  upgrading  the  capacity  of  the  electric  plant  and  distribution  system  once  the 
ship  is  built  is  usually  prohibitive.  In  this  sense,  capacity  expansion  onboard  ships  is  not 
done.  Instead,  excess  capacity  is  initially  installed  to  account  for  projected  growth  in  load. 

The  maximum  load  for  a  ship  design  is  determined  by  tabulating  every  load  in  an 
Electrical  Load  Summary  and  summing  up  the  power  requirements  under  different 
operating  conditions.  The  maximum  projected  load  usually  occurs  when  the  ship  is  in  battle 
condition  and  the  ambient  temperature  is  low  (Electric  heaters  are  used  in  many  areas  of  a 
ship).    To  account  for  uncertainty  in  estimating  loads,  a  20  %  margin  is  added  to  the 
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maximum  projected  load.  Another  20  %  margin  is  added  for  capacity  expansion 
requirements.  Ninety  percent  of  the  capacity  of  all  but  one  of  the  installed  generators  must 
meet  or  exceed  the  margined  maximum  projected  load.  The  ninety  percent  requirement 
allows  for  imprecise  load  sharing  when  at  maximum  load  while  the  all  but  one  requirement 
accounts  for  taking  one  generator  off  line  for  maintenance. 

Figure  2.3-1 

U.S.  Ships  -  Electrical  Loads 


if 


Propulsion 


Aui  Systems  ^OC  HVAC       \V  Combat  Systems 


Once  the  size  of  the  electric  plant  is  determined,  there  are  a  number  of  other 
considerations  that  must  be  accounted  for.  GENSPECS6  require  the  system  be  ungrounded 
and  based  on  Split  Plant  Operation  (Each  generator  operating  independently)  with  the 
capability  for  parallel  operation.  Electromagnetic  Interference  (EMI)  and  Electromagnetic 
Pulse  (EMP)  requirements  place  further  constraints  on  the  electric  plant  design  and  are 
detailed  in  MIL-STD-461  and  MIL-STD-1310.  Since  warships  are  designed  for  combat, 
they  must  also  be  capable  of  surviving  severe  mechanical  shocks  from  exploding  ordnance. 
The  shock  requirements  are  particularly  important  for  electrical  equipment  such  as  circuit 
breakers  and  generators.  Specific  requirements  for  shock  are  listed  in  MIL-STD-901 . 


6  General  Specifications  for  Ships  of  the  Unites  States  Navy 
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A  number  of  loads  onboard  a  ship  are  very  important  for  survival  of  the  ship  and  crew 
during  combat  and  emergencies.  These  loads  are  designated  vital  loads  and  must  be 
provided  with  primary  and  alternate  sources  of  power.  Some  of  the  vital  loads  have 
automatic  bus  transfer  switches  (ABT)  which  switch  to  the  alternate  source  automatically 
on  loss  of  the  primary  source.  Others  use  manual  bus  transfer  switches  (MBT).  Examples 
of  vital  loads  include: 

Collective  Protection  System  Class  W                              ABT 

Ventilation 

Emergency  Communications  MBT 

Emergency  Lighting  ABT 

Fire  Pumps  ABT 

AFFF  Pumps  ABT 

Interior  Communications  ABT 

Machinery  Space  Circle  W  Ventilation  MBT 

Steering  Gear  Auxiliaries  ABT 

Surface  Search  Radar  MBT 

VHF  Bridge-to-Bridge  Radio  MBT 

Vital  Propulsion  Auxiliaries  MBT  and  ABT 

Auxiliaries  to  support  generator  prime  MBT 

movers 

From  a  naval  architectural  viewpoint,  the  placement  of  electric  generators  requires  a 
number  of  compromises.  Placing  the  heavy  generators  as  low  as  possible  is  beneficial  for 
hydrostatic  stability  purposes.  The  lower  the  generator  however,  the  more  volume  is 
required  for  intake  and  exhaust  ducting.  Gas  turbine  generators  are  lighter  than  diesel 
generators,  but  require  greater  volumes  of  air.  Furthermore,  design  requirements  exist  for 
separating  50  %  of  the  installed  capacity  by  two  watertight  bulkheads  and  installing  a 
minimum  of  three  generators.  Generally,  weight  can  be  minimized  by  using  the  smallest 
number  of  generators  (three).  However,  if  four  generators  are  used,  the  generators  can  be 
located  in  two  machinery  spaces  instead  of  three.  By  using  only  one  set  of  intake  and 
exhaust  ducts,  volume  for  ductwork  can  also  be  reduced.  Since  most  recent  ships  have  had 
weight  constraints  placed  on  them  by  Congress,  the  minimum  number  of  generators  have 
been  used.7 


7  A  very  simple  cost  model  for  warships  assigns  a  cost  per  ton  of  different  components  of  a 
ship.  With  this  in  mind  Congress  has  in  the  past  placed  constraints  on  the  weight  of  ships  in 
order  to  keep  costs  down. 
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Enclaving  is  a  concept  for  arranging  ships  which  involves  locating  all  the  equipment 
required  for  a  given  combat  system  within  the  same  general  area  of  the  ship.  If  a  ship  is 
completely  divided  into  a  number  of  enclaves,  one  enclave  can  be  damaged  by  enemy 
ordnance  while  the  others  remain  functional  and  capable  of  continuing  the  engagement.  To 
work  properly,  this  concept  requires  the  enclaving  of  sources  of  distributed  services  (such  as 
electricity,  cooling  water,  fire  fighting  water  and  dry  air).  Presently,  enclaving  has  not  been 
incorporated  in  any  warship  design  but  its  use  has  been  proposed  for  a  number  of  new 
designs8.  If  enclaves  are  ever  used,  they  will  have  a  significant  impact  on  the  type,  size, 
number,  and  location  of  electric  generators.  In  some  enclaves  it  may  not  even  be  possible  to 
locate  a  conventional  generator.  Alternate  generating  or  storage  devices  such  as  fuel  cells 
or  batteries  may  be  used. 

2.4  Integrated  Electric  Drive 

Most  modem  warships  mechanically  couple  the  main  propulsion  prime  movers  with 
the  propeller  shaft.  The  mechanical  power  train  is  very  efficient  but  imposes  constraints  on 
machinery  arrangement  and  adversely  impacts  survivability.  The  prime  mover  is  usually 
very  heavy  and  must  be  located  near  the  center  of  the  ship  to  prevent  excess  trim.  Shafting 
must  therefore  penetrate  a  number  of  watertight  boundaries  and  maintain  precise  alignment 
over  a  great  distance.  The  long  length  and  precision  requirements  of  the  shafting  make  it 
very  vulnerable  to  weapon  induced  damage.  While  electric  propulsion  eliminates  many  of 
the  survivability  and  arrangement  constraints  of  the  mechanical  system,  the  propulsion 
system  must  be  carefully  designed  to  ensure  overall  plant  efficiency  is  not  degraded  by  the 
extra  power  conversion  losses  in  converting  to  and  from  electric  power.  Designed  properly, 
an  electric  drive  system  can  achieve  the  survivability  and  arrangeability  benefits  without 
suffering  from  a  lower  propulsion  plant  efficiency. 

Integrated  electric  drive  interconnects  the  generation  of  power  for  propulsion  with  the 
generation  of  ship  service  electric  power.  The  propulsion  plant  for  U.S.  warships  typically 
averages  between  30  and  37.5  MW  per  shaft.  The  capacity  is  sized  to  provide  enough 
power  to  propel  the  ship  at  a  desired  maximum  speed.  Most  ships  however,  do  not  operate 
for  extended  periods  of  time  at  maximum  speed.  Operating  at  half  maximum  speed  requires 
only  about  20  percent  of  the  installed  power  and  quarter  maximum  speed  requires  only  2  or 


8  Enclaving  requires  a  greater  redundancy  of  equipment  which  results  in  the  ship  becoming 
larger  and  more  expensive.  Since  most  ship  designs  are  cost  constrained,  enclaving 
provisions  are  often  deleted  to  reduce  the  per  unit  price  of  the  warships. 
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3  percent.  Thus  a  28  knot  frigate  with  a  30  MW  plant  could  go  7  knots  using  less  than  1 
MW  of  power  and  14  knots  with  about  6  MW  of  power.  If  the  propulsion  plant  consists  of 
nvo  15  MW  generators,  one  generator  could  easily  supply  all  the  required  power  for  both 
propulsion  and  ship  service  at  the  normal  operating  speeds  of  12  to  15  knots.  This  has  the 
potential  of  reducing  the  fuel  consumption  of  warships  under  normal  operating  conditions 
by  improving  the  overall  efficiency  of  the  power  plant  even  though  the  efficiency  of  the 
power  transmission  system  is  lower.  By  careful  selection  of  generator  number  and  size,  one 
can  rune  the  overall  efficiency  of  a  plant  for  optimization  at  several  different  speeds.  In  the 
U.S.  Navy,  optimizing  plant  efficiency  for  20  knots  is  beneficial  since  this  is  the  speed  used 
to  calculate  the  amount  of  fuel  carried  by  the  ship.9 

In  a  typical  integrated  electric  drive  scheme,  the  propulsion  prime  movers  are 
connected  to  both  a  propulsion  generator  and  to  a  ship  service  generator  (PDSS  or 
Propulsion  Derived  Ship  Service).  The  speed  of  the  generator  is  set  to  optimize  efficiency 
of  the  prime  mover  at  the  given  power  loading.  Consequently,  cycloconverters  are  used  to 
convert  the  power  to  either  60  Hz  for  ship  service,  or  to  whatever  frequency  the  propulsion 
motors  require.  Usually,  an  additional  diesel  or  gas  turbine  ship  service  generator  is 
included  to  provide  power  in  port  or  during  emergencies.  Figure  2.4-1  shows  a  typical 
PDSS  design  for  a  two  shaft  frigate  sized  ship. 

Figure  2.4-1  emphasizes  the  need  to  model  mechanical  dynamics  and  control 
information  signals.  The  control  signals  can  couple  the  dynamics  of  different  devices 
within  the  system  and  must  therefore  be  carefully  modelled.  The  control  signals  can  also 
destroy  such  properties  as  diagonal  dominance  which  makes  analysis  of  commercial  power 
systems  much  easier. 

One  of  the  features  of  an  electric  drive  system  which  may  be  exploited  in  the  future  is 
the  ability  to  divert  all  of  the  propulsion  power  capacity  from  propulsion  to  some  sort  of 
high  power  combat  system.  Weapons  such  as  rail  guns  and  high  energy  lasers  may  become 
possible.  These  types  of  weapons  would  be  safer  for  the  ship  since  the  requirement  to  store 
large  amounts  of  chemical  explosives  for  propellent  charges  would  be  reduced.  Energy  to 
move  projectiles  would  be  stored  in  the  form  of  relatively  inert  fuel  oil  instead  of  highly 


9  Most  other  navies  use  18  knots  which  allows  for  combined  plants  such  as  CODOG  where  a 
diesel  engine  is  used  for  cruising  and  a  gas  turbine  for  high  speed.  Unfortunately,  the  size 
requirement  for  a  diesel  capable  of  propelling  a  ship  at  20  knots  is  prohibitive  and  results  in 
U.S.  warships  only  using  gas  turbines  and  carrying  much  more  fuel. 
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Figure  2.4-1  Integrated  Electric  Drive 
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explosive  chemical  propellents.  Switching  large  amounts  of  electric  power  onboard  ships 
presents  a  number  of  technical  challenges  both  in  the  design  of  physical  equipment  and  also 
in  attempts  to  accurately  simulate  the  phenomena.  The  effect  of  pulse  loads  on  the  electric 
system  is  not  a  trivial  simulation  problem. 
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Chapter  3  Framework 

Conducting  time  domain  simulations  of  systems  of  nonlinear  lumped  parameter  models 
characterizing  shipboard  electric  power  systems  requires  an  organized  approach  to 
developing  device  models  as  well  as  network  equations.  The  major  contribution  of  this 
thesis  is  the  development  of  a  simulation  environment  having  the  following  properties: 

1.  An  object  oriented  approach  to  developing  the  mathematical  description  of  devices 

independent  of  the  manner  in  which  the  variables  are  represented. 

2.  An  organized  method  for  generating  system  equations  for  interconnecting  device 

models  into  subsystems  and  systems. 

3.  An  algorithm  for  solving  the  system  equations  and  variables  by  identifying  smaller 

blocks  of  equations  and  variables  which  can  be  sequentially  solved.  The 
algorithm  develops  the  concept  of  the  device  structural  jacobian  matrix  and  the 
system  structural  jacobian  matrix. 

4.  The  ability  to  use  a  wide  range  of  methods  to  describe  variable  waveforms.    In 

particular,  describing  waveforms  through  vectors  of  coefficients  of  polynomial 
series,  orthogonal  function  series,  and  data  series  are  stressed. 

5.  The  ability  to  solve  the  system  of  equations  by  employing  either  the 
Newton-Raphson  Method  or  Waveform  Relaxation.  The  Newton-Raphson 
method  is  modified  to  improve  convergence  properties  through  the  use  of 
continuation  methods. 

This  chapter  is  organized  into  five  parts.  The  first  part  defines  the  device  which  is  the 
fundamental  building  block  of  the  system  simulation.  The  second  part  shows  how  to 
interconnect  several  device  models  into  systems  and  subsystems.  The  third  part  defines  the 
waveform  as  a  vector  of  coefficients  to  approximate  waveforms  over  time  intervals.  The 
fourth  part  details  the  actual  procedure  for  conducting  a  simulation.  The  fifth  and  final  part 
details  some  finer  points  which  should  be  considered  when  constructing  models. 
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3.1  Device  Description 

A  Device  Description  is  an  organized  manner  for  describing  the  characteristics  of 
a  physical  component.  This  description  includes  definitions  of  variables  which  interface 
with  other  components  in  a  system,  variables  called  states  which  allow  for  information 
storage,  and  constitutive  relations  describing  the  device  behavior. 

3.1.1  Interface  Variables 

The  interface  variables  are  defined  as  either  potential  variables  or  flow 

variables  depending  on  their  interaction  with  the  interface  variables  of  other  devices 
within  a  system  or  subsystem.  Systems  and  subsystems  are  constructed  by  grouping 
the  interface  variables  of  one  or  more  devices  into  sets  called  nodes  and  applying 
network  equations  determined  by  the  types  of  variables  attached  to  the  nodes. 

All  potential  variables  attached  to  a  node  are  equated  to  a  potential  value 
associated  with  the  node.  Physical  quantities  which  can  be  classified  as  potentials  include 
voltages,  signal  levels,  rotational  speeds,  deflections,  and  pressures.  All  potentials  are 
referenced  to  0.  All  potential  variables  connected  to  the  same  node  must  be  defined  with 
respect  to  the  same  system  wide  reference  level.  In  other  words,  0  must  mean  the  same 
thing  for  all  of  the  potentials  attached  to  a  given  node. 

The  sum  of  all  flow  variables  attached  to  a  node  is  equated  to  zero.  Physical 
quantities  analogous  to  flow  variables  include  currents,  power  flows,  torques,  forces  and 
mass  flow  rates. 

3.1.2  Terminals 

Terminals  provide  a  mechanism  for  organizing  the  interface  variables  of  a  device. 
In  general,  there  are  two  types  of  terminals:  Normal  Terminals  and  Information 
Terminals. 

A  normal  terminal  has  associated  with  it  a  flow  variable  and  a  potential  variable. 
Its  electrical  analog  is  one  of  the  wiring  terminals  on  an  electrical  device.  A  mechanical 
analog  is  the  rotating  shaft  coupling  of  a  gearbox.  The  equations  for  exchanging  energy 
between  devices  can  be  generated  through  the  list  of  normal  terminals  connected  together 
at  a  given  node. 
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An  information  terminal  has  associated  with  it  only  a  potential  variable.  The 
potential  variable  is  used  to  convey  knowledge  between  devices  without  transferring 
energy.  Set  points,  meter  readings,  and  control  signals  are  all  examples  of  energyless  data 
which  can  be  conveyed  through  infonnation  terminals. 

All  normal  tenninals  have  an  associated  KCL  Group  number.  A  KCL  group  is  the 
smallest  subset  of  a  device's  terminals  such  that  the  sum  of  the  flow  variables  within  the 
subset  is  identically  zero  for  at  least  one  of  the  possible  dynamic  configurations  of  the 
device.  Normal  terminals  which  can  not  be  associated  with  a  KCL  group  are  given  a  group 
number  of  0.  The  remaining  tenninals  are  assigned  the  group  number  of  their  parent  KCL 
group. 

The  KCL  Group  number  is  used  to  detect  possible  reference  frame  problems  within  a 
simulation  network.  A  given  electrical  circuit  problem  for  example,  must  have  at  least  one 
normal  terminal  with  a  0  group  node  within  a  given  independent  system  to  ensure  the  set 
of  system  KCL  equations  is  not  singular.  Nonnally  this  terminal  is  associated  with  a  one 
terminal  device  with  an  export  potential  and  import  flow  which  is  used  to  specify  the  value 
of  a  given  reference  node  potential.  This  Reference  Frame  Check  is  discussed  in  greater 
detail  in  section  3.2.4. 

Some  devices  may  have  variable  numbers  of  KCL  Groups  depending  on  the 
operating  point  of  the  device.  A  simple  model  of  a  two  terminal  switch  for  example, 
would  have  1  KCL  group  when  the  switch  is  closed  (the  sum  of  the  currents  entering  the 
switch  is  identically  zero)  and  2  KCL  groups  when  the  switch  is  open  (both  flow  variables 
are  identically  zero).  For  the  purpose  of  defining  the  device,  the  worst  case  in  terms  of 
creating  singular  systems  should  be  used.  In  the  switch  example,  each  terminal  should 
have  their  own  KCL  group  number  for  a  total  of  two  KCL  groups. 

3.1.3  Variable  Direction:  Import  and  Export  Variables 

The  Interface  variables  can  further  be  classified  by  whether  they  are  a  resource 
(Import)  or  product  (Export)  of  the  device  description.  A  device  description  can  be 
considered  a  means  for  generating  export  variables  based  on  the  values  of  the  import 
variables,  states,  parameters,  continuation  parameter,  and  time. 

An  import  variable  is  taken  as  input  by  the  device  description.  An  import  variable 
can  be  any  interface  variable  associated  with  either  normal  or  information  terminals.    To 
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ensure  a  consistent  set  of  equations  when  several  devices  are  connected  together  in  a 
system,  the  total  number  of  import  variables  associated  with  normal  terminals  must  equal 
the  number  of  normal  terminals 

An  export  variable  is  explicitly  defined  and  considered  a  product  of  the  device 
description.  An  export  variable  can  be  any  interface  variable  associated  with  either  normal 
or  information  terminals.  To  ensure  a  consistent  set  of  equations  when  several  devices  are 
connected  together  in  a  system,  the  total  number  of  export  variables  associated  with 
normal  terminals  must  equal  the  number  of  normal  terminals. 

3.1.4  States 

States  are  variables  whose  values  are  stored  for  a  given  time  for  later  use.  States 
can  be  used  for  example,  to  store  the  constant  of  integration  for  a  dynamic  equation.  States 
can  also  be  used  to  store  the  operating  mode  for  a  given  device.  In  general,  if  the  value  of 
a  given  variable  depends  on  the  previous  value  of  another  variable,  that  other  variable  is  a 
state. 

3.1.5  Parameters 

Parameters  are  constants  which  specify  characteristics  of  the  device  or  in  other 
words,  customizes  a  given  device  description  to  represent  a  given  physical  device.  A 
model  of  a  resistor  for  example,  includes  a  parameter  for  resistance.  This  precludes  the 
requirement  to  develop  a  model  for  every  resistor  value.  We  only  need  construct  a  generic 
resistor  model  instead  of  a  10K  resistor  model,  a  22K  resistor  model,  etc. 

3.1.6  Constitutive  Equations 

The  constitutive  equations  are  a  consistent  set  of  equations  for  specifying  the 
values  of  the  states  and  export  variables.  In  general,  the  number  of  constitutive  equations 
needed  is  equal  to  the  number  of  normal  terminals  plus  the  number  of  export  variables 
associated  with  information  terminals.  The  total  number  of  import  variables  associated 
with  normal  terminals  and  the  total  number  of  export  variables  associated  with  normal 
terminals  must  independently  equal  the  number  of  normal  terminals.  There  is  no 
constraint  on  the  number  of  import  variables  associated  with  information  terminals. 
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3.1.7  Device  Jacobian  Matrices 

A  Device  Jacobian  Matrix  provides  the  sensitivities  (partial  derivatives)  of  the 
export  variables  with  respect  to  the  import  variables.  This  implies  there  is  a  given 
ordering  of  both  the  import  Xt  and  export  XE  variables: 
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The  Device  Jacobian  Matrix  is  used  to  generate  a  consistent  set  of  import  variables 
which  simultaneously  satisfy  the  device  constitutive  equations  along  with  constraints 
imposed  by  the  connections  of  terminals  to  nodes.  From  the  device  point  of  view  however, 
the  Jacobian  matrix  is  merely  a  product  that  must  be  computed. 

Up  to  this  point,  we  have  not  discussed  the  manner  in  which  the  variables  are 
described.  If  the  variables  are  represented  by  real  numbers,  then  each  element  of  the 
Jacobian  is  also  a  real  number.  If  instead  the  variables  are  represented  by  vectors,  then  the 
Jacobian  elements  will  be  matrices. 

3.1.8  Device  Structural  Jacobian  Matrix 

The  Device  Structural  Jacobian  Matrix  describes  the  properties  of  the  elements 
of  the  device  Jacobian  matrix  for  a  given  type  of  variable  representation  without  actually 
providing  any  values.  The  following  codes  can  be  used  to  describe  the  properties  of  the 
matrix  elements  of  the  device  Jacobian  matrix: 


Code 

Type  of  Matrix 

0 

Zero  Matrix  (all  elements  are  always  zero) 

I 

Identity  Matrix  (always  the  identity  matrix) 

D 

Diagonal  Matrix  (always  a  linear  main  diagonal  matrix) 

L 

Linear  Matrix  (The  elements  are  always  constant) 

A 

Nonlinear  AC  Matrix  (see  Note  3.1.8-1) 

N 

Nonlinear  Matrix  (The  elements  may  not  be  constants) 

U 

Unknown  (The  dependence  is  unknown  (treat  as  nonlinear)) 

Note  3.1.8-1:  An  AC  Matrix  is  one  for  which  the  constant  component  of  the  export 
variable  depends  only  on  the  constant  component  of  the  import  variable.  The  other 
components  of  the  export  variable  can  not  depend  on  the  constant  component  of  the 
import  variable  but  are  not  restricted  in  any  other  way. 

The  device  structural  Jacobian  matrix  is  useful  in  developing  the  algorithm  for 
generating  a  consistent  set  of  import  variables  without  having  to  deal  directly  with  the 
potentially  much  larger  device  Jacobian  matrices.  If  an  iterative  solution  scheme  is  used  to 
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develop  the  consistent  set  of  import  variables,  the  device  structural  Jacobian  matrix 
indicates  directly  which  matrix  elements  must  be  recalculated  for  each  iteration.  (Only  the 
nonlinear  and  unknown  elements  have  values  which  change  between  iterations) 

3.1.9  Continuation  Parameter 

A  system  containing  one  or  more  nonlinear  devices  may  be  difficult  to  solve  with  an 
iterative  method.  The  region  of  convergence  around  the  solution  may  be  so  small  as  to 
make  the  probability  of  success  for  choosing  a  starting  point  for  the  iterative  scheme 
almost  zero.  One  method  for  enlarging  the  region  of  convergence  is  through  the  use  of  a 
continuation  parameter  which  varies  from  0  to  1.  When  the  continuation  parameter 
has  value  1,  the  export  variables  are  developed  using  the  normal  nonlinear  constitutive 
equations.  When  the  continuation  parameter  has  value  0  however,  the  export  variables  are 
developed  using  a  linear  set  of  constitutive  equations.  As  the  continuation  parameter 
increases  from  0  to  1,  the  export  variables  traverse  a  continuous  path  from  the  linear 
solution  to  the  nonlinear  solution.  One  common  method  for  generating  such  a  dependence 
on  a  continuation  parameter  a  is: 

F(X,a)  =  aFn(X)  +  (l-a)Fl(X) 

where  Fn(X)  is  the  nonlinear  function  for  generating  the  export  variables,  Fj(X)  is  the 
linear  function  approximation,  and  F(X,a)  is  the  function  for  determining  the  export 
variables  for  intermediate  values  of  a.  Section  3.4.2  describes  in  detail  continuation 
parameters  in  relation  to  the  Newton-Raphson  method. 

3.1.10  Discontinuity  Time  Prediction 

If  the  variables  are  described  as  a  waveform  over  a  given  time  interval  [/0Al 
knowledge  of  the  time  of  discontinuities  can  prove  useful  to  the  algorithm  which  generates 
the  consistent  set  of  import  variables.  The  accuracy  of  a  vector  description  of  a  waveform 
often  deteriorates  greatly  if  there  is  a  discontinuity  during  the  time  interval.  Varying  tx 
such  that  it  falls  on  a  discontinuity  will  often  improve  the  accuracy  of  the  waveform 
representation.  For  this  reason,  each  device  has  the  opportunity  to  recommend  a 
recalculation  time  for  the  current  interval.  Normally,  the  system  would  use  the  minimum 
recommended  recalculation  time  offered  by  any  of  the  devices  to  recompute  the  time 
interval. 
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3.2  Network  Description 

A  network  is  composed  of  a  system  of  devices  and  subsystems  whose  terminals 
are  interconnected  at  nodes.  The  network  is  a  closed  system  having  no  terminals  defined 
for  any  of  its  nodes.  A  subsystem  is  a  system  having  terminals  defined  for  at  least  one  of 
its  nodes  and  therefore  can  not  be  solved  independently  of  other  devices  or  subsystems. 

3.2.1  Nodes 

A  node  connects  together  one  or  more  terminals  from  one  or  more  devices.  The 
nodal  connections  are  the  means  by  which  devices  are  combined  to  form  systems  (both 
networks  and  subsystems).  The  nodes  provide  the  association  of  device  import  and  export 
variables  with  system  variables  through  nodal  equations.  Each  node  is  assigned  a 
serial  number  for  identifying  it  from  the  other  nodes.  There  are  two  types  of  Nodes: 
Normal  Nodes  and  Information  Nodes. 

3.2.1.1  Normal  Nodes 

A  Normal  Node  has  at  least  one  normal  terminal  attached  to  it.  Information 
terminals  can  be  associated  with  the  node  as  long  as  none  of  the  information  terminal 
potentials  are  defined  as  an  export  variable.  A  normal  node  has  associated  with  it  a  node 
potential  as  well  as  a  Kirchhoff  Current  Law  (KCL)  equation.  The  number  of  normal 
nodes  is  designated  by  n„. 

In  a  subsystem,  a  normal  node  can  also  have  associated  with  it  a  terminal  for 
connecting  with  other  subsystems  and  devices.  This  terminal  can  be  either  a  normal 
terminal  having  an  associated  terminal  potential  and  flow  variable  or  an  infonnation 
terminal  having  only  an  export  potential,  (import  and  export  refer  here  to  the  direction 
relative  to  the  defining  subsystem  which  is  opposite  to  the  normal  definition  which  is 
relative  to  the  components  of  the  subsystem).  The  total  number  of  normal  node  normal 
terminals  defined  for  a  subsystem  is  designated  nntn.  For  any  given  subystem  the  number 
of  normal  node  terminal  export  variables  and  import  variables  must  both  independently 
equal  nntn.  The  total  number  of  normal  node  information  terminals  is  designated  nnn. 

3.2.1.2  Information  Nodes 

An  Information  Node  has  only  information  terminals  attached  to  it.  Furthermore, 
one  and  only  one  of  the  terminal  potential  variables  must  be  an  export  variable.  Only  a 
node  potential  is  associated  with  an  information  node.    Information  nodes  work  in  the 
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same  manner  as  hooking  up  stereo  componenents:  you  can  hook  up  as  many  inputs 
(import  variables)  as  you  want  to  any  given  output  (export  variable),  but  should  never 
hook  up  two  or  more  outputs  together.  The  number  of  information  nodes  is  designated  by 

71,. 

As  an  option  for  subsystems,  an  information  node  can  have  associated  with  it  an 
information  terminal  for  connecting  with  other  subsystems.  Since  the  meanings  of  import 
and  export  are  once  again  reversed  for  this  terminal,  no  other  export  potentials  from  other 
devices  or  subsystems  may  be  attached  to  the  node  if  the  information  terminal  potential  is 
an  import  variable.  If  the  information  terminal  potential  is  an  export  variable,  exactly  one 
other  export  potential  from  other  devices  or  subsystems  may  be  attached  to  the  node.  The 
total  number  of  information  node  information  terminals  is  designated  n^. 

3.2.2  System  Variables 

System  variables  comprise  the  minimum  set  of  variables  from  which  all  of  the 
device  import  and  export  variables  can  be  derived  from.  The  set  of  system  variables  is 
composed  of  node  potentials  as  well  as  all  device  import  flow  variables  and  normal  node 
normal  terminal  export  flow  variables.  For  a  subsystem,  the  node  terminal  import 
variables  are  assumed  to  be  provided  by  the  encompassing  system  or  subsystem  and  are 
not  considered  system  variables. 

3.2.2.1  Node  Potentials 

All  of  the  node  potentials  of  the  normal  and  information  nodes  are  system  variables 
which  must  be  solved  for.  Hence  there  are  a  total  of  np~  nn  +  nt  node  potentials. 

3.2.2.2  System  Flow  Variables 

All  of  the  Import  Flow  Variables  of  the  various  devices  making  up  the  system  as 
well  as  the  export  flow  variables  of  the  normal  node  terminals  are  system  variables.  The 
number  of  system  flow  variables  is  designated  by  nf. 

3.2.3  System  Equations 

3.2.3.1  Kirchhoff  Current  Law  Equations 

Kirchhoff's  current  law  states  the  sum  of  the  flow  variables  entering  a  node  is  equal 
to  zero.    For  a  given  normal  node  or  normal  terminal  node,  this  law  is  expressed  by 
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generating  a  list  of  the  terminals  of  the  various  devices  and  subsystems  attached  to  the 
node.  The  number  of  Kirchhoff  Current  Law  equations  is  equal  to  the  number  of  normal 
nodes  nn. 

ffi  =  £  h = ° 

* = i 

where 

fjO  KCL  Equation  for  node./  (Should  Equal  Zero) 

n,  Number  of  normal  terminals  attached  to  node 

Iji  Flow  Variable  associated  with  ith  normal  terminal  attached  to  node  j 

3.2.3.2  Potential  Difference  Equations 

A  Potential  Difference  Equation  is  created  for  each  of  the  export  potential 
variables  of  the  various  devices  and  other  subsystems  and  for  each  of  the  import  potential 
variables  of  the  node  terminals.  This  equation  merely  states  the  difference  between  the 
node  potential  and  the  potential  variable  is  zero.  This  equation  is  expressed  by 
generating  a  list  of  the  terminals  of  the  various  devices  and  subsystems  attached  to  the 
node  having  an  export  potential  variable.  Since  one  and  only  one  export  information 
potential  can  be  assigned  to  an  information  node  and  can  never  be  attached  to  a  normal 
node,  the  number  of  potential  equations  due  to  export  information  potentials  is  simply  n,. 
The  requirement  for  a  device  to  have  equal  number  of  import  and  export  variables 
associated  with  normal  terminals  forces  the  number  of  export  normal  potentials  to  be  rij. 
Hence  the  total  number  of  potential  equations  is  nY  -  w,  +  nf. 

f. .()  =  V  -  V .  =  0 

Jji\S  J  J' 

where 

/pi)  Potential  Difference  Equation  for  node  j  export  potential  variable  i 

(Should  Equal  Zero) 

Vj  Nodey  Potential 

Vjj  ith  export  potential  variable  associated  with  node/ 
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3.2.3.3  Rmin  and  Gmin 

One  method  for  preventing  linear  dependences  among  the  system  equations  is  to 
modify  the  equations  to  include  an  extra  term  corresponding  to  either  a  small  conductance 
Gmjn  to  the  ground  potential  for  KCL  equations  or  a  small  series  resistance  Rm,n  for  the 
potential  difference  equations.  The  KCL  equation  is  now  given  by: 

#)  =  guv} +!/,  =  <) 

1  =  1 
The  potential  difference  equation  is  similarly  modified: 

f()  =  V-V-R    1=0 

J ji\/  j  ji  mm   ji 

The  goal  in  using  Gmi„  and  R^,,  is  to  reduce  the  condition  number  of  the  system 
Jacobian  matrix  to  the  point  where  the  system  can  reliably  be  solved  (A  singular 
matrix  has  an  infinite  condition  number).  Gmin  and  Rmi„  can  also  add  fictitious  dynamics 
to  the  system  and  thereby  lead  the  simulation  to  produce  incorrect  results.  Hence  if  used, 
G^n  and  Rmi„  should  be  large  enough  to  bring  the  condition  number  down  to  a  reasonable 
level,  but  small  enough  to  prevent  their  inclusion  from  having  appreciable  effect  on  the 
simulation  results. 

In  general,  the  use  of  Gmin  and  /?„„•„  should  be  avoided  for  these  reasons: 

1.  Gmin  and  Rmi„  are  fictitious  elements.  If  either  is  significant,  they  should  be 
explicitly  included  as  a  device. 

2.  The  mdiscriminite  use  of  Gmi„  and  Rmin  adds  to  the  complexity  of  the  system 
and  decreases  the  degree  to  which  the  system  can  be  reduced  into  smaller  blocks. 
In  other  words  the  inclusion  of  Gmin  and  Rmin  may  greatly  increase  the  computation 
time. 

Gmin  and  Rmin  are  included  in  WAVESEVI  for  these  reasons 

1.  Gmin  and  Rmin  can  be  selectively  specified  for  individual  nodes.  If  a  simulation 
fails  to  converge  for  one  reason  or  another,  Gmi„  and  Rmin  can  be  employed  to  find 
the  part  of  the  system  experiencing  difficulties.  GmiH  and  Rmin  are  excellent 
debugging  tools. 
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2.  Since  Gmin  effectively  connects  the  node  to  the  ground  potential,  Gmi„  can  be 
used  to  ensure  all  of  the  nodes  have  the  same  potential  reference  and  ensure  there 
are  no  linear  dependent  KCL  equations. 
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3.2.4  Reference  Frame  Testing 

If  a  given  set  of  a  system's  normal  nodes  can  be  found  such  that  all  terminals 
attached  to  any  of  its  nodes  have  nonzero  KCL  groups  and  such  that  if  a  terminal  is 
attached  to  one  of  the  set's  nodes,  then  all  of  remaining  terminals  of  the  parent  KCL  group 
are  also  attached  to  one  of  the  nodes  of  the  set,  then  there  exists  the  possibility  of  a  singular 
system  due  to  the  linear  dependence  of  the  KCL  equations  for  the  set  of  normal  nodes. 

If  G^  is  non-zero  for  a  node,  it  should  be  considered  a  terminal  with  a  0  KCL 
Group.  If  Gmin  is  zero,  it  should  be  ignored. 

Testing  for  a  possible  singular  system  can  be  accomplished  with  the  following 
algorithm: 

1.  Set  all  the  normal  node  circuit_group_indicators  to  0. 

Set  the  circuit_group_counter  to  0 

Set  the  circuit_group_singular_f lag  to  0 

2.  Start  with  the  first  normal  node  having  a  0  circuit_group_indicator 

If  none  can  be  found  then  algorithm  is  complete. 
Increment  circuit_group_counter. 

3.  Change  the  circuit_group_indicator  of  the  node  to  the 

circuit_group_counter. 

4.  For  each  terminal  attached  to  the  node: 

4a.  If  the  KCL  group  number  is  zero,  set  the 

circuit_group_singular_f  lag  to  1. 

4b.  If  the  KCL  group  number  is  nonzero,  loop  through  each  normal 
terminal  of  the  device.  If  the  terminal  belongs  to  the  same 
KCL  group  and  the  node  the  tenninal  is  attached  to  has  a 

0  circuit_group_indicator,  then  set  the  node 
circuit_group_indicator  to  the  negative 
of  the  circuit_group_counter. 

5.  Search  all  of  the  nodes  for  a  negative  circuit_group_indicator 

If  none  can  be  found  and  the  circuit_group_singuiar_fiag  is  zero 
Warn  user  that  a  singular  system  may  exist  with  the  group  nodes. 
If  none  can  be  found  then  go  to  step  2 
If  one  is  found,  then  go  to  step  3 
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Setting  a  proper  reference  for  each  such  set  of  system  nodes  can  be  accomplished  by 
attaching  to  one  of  the  nodes  a  one  terminal  device  having  the  following  characteristics: 

3.2.4.1  Reference  Device 

Interface  Variables 

Terminal  Potential  Variable        Flow  Variable  (KCL  Grp)  Type 

Ref  V  (export)  /(import)  (0)  Normal 

Parameters 

VRej  Reference  Potential  Level 


Equations 


Device  Structural  Jacobian 


v=vRef 


JDS  =  [0] 


Device  Jacobian 


JD  =  [0] 


Notes 

Most  conventional  circuit  simulations  define  a  reference  node  for  which  a  potential 
is  defined  and  the  KCL  equation  is  not  written.  Adding  this  reference  device  to  a  node 
effectively  converts  that  node  to  a  reference  node  in  the  usual  senses.  While  it  is  true  that 
the  KCL  equation  and  an  additional  Potential  Difference  equation  are  still  written  for  this 
reference  node,  each  is  part  of  a  one  element  block.  The  potential  difference  equation  can 
be  solved  before  the  simulation  starts  since  it  does  not  depend  on  any  of  the  system 
variables.  The  flow  variable  on  the  other  hand,  only  appears  in  the  KCL  equation  of  the 
one  node  and  thus  can  be  solved  after  all  the  other  system  variables  have  been  found.  In 
fact,  the  flow  variable  should  normally  equal  zero  if  the  rest  of  the  circuit  is  indeed 
linearly  dependent. 

As  a  convenience  to  the  user,  WAVESEM  automatically  attaches  a  reference  device 
with  Vrej  =  0  to  the  node  with  serial  number  0  if  that  node  is  used. 
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3.2.5  System  Reduction 

The  previous  sections  detail  a  method  for  generating  a  full  set  of  system  variables 
and  system  equations.  The  total  number  of  system  variable  equals  ns/  =«„  +  w,  +  rij  which 
also  equals  the  number  of  system  equations.  For  even  a  small  system  the  algebraic  order 
ntj  can  become  quite  large.  For  this  reason,  elminating  system  variables  and  equations 
through  system  reduction  is  desirable.  The  primary  tool  for  performing  system  reduction 
is  the  system  structural  Jacobian. 

3.2.5.1  System  Structural  Jacobian 

The  System  Structural  Jacobian  facilitates  the  reduction  of  the  algebraic  order 
of  the  system  by  showing  the  nature  of  the  dependence  of  system  equations  to  each  of  the 
system  variables.  The  System  Structural  Jacobian  is  constructed  by  combining  elements 
of  the  device  structural  Jacobian  matrices  according  to  the  arithmetic  of  structural 
Jacobian  elements.  The  types  of  elements  in  the  system  structural  Jacobian  is  given  by: 


Code 

Type  of  Matrix 

0 

Zero  Matrix  (all  elements  are  always  zero) 

I 

Identity  Matrix  (always  the  identity  matrix) 

D 

Diagonal  Matrix  (always  a  linear  main  diagonal  matrix) 

L 

Linear  Matrix  (The  elements  are  always  constant) 

A 

Nonlinear  AC  Matrix  (see  Note  3.2.5.1-1) 

N 

Nonlinear  Matrix  (The  elements  may  not  be  constants) 

U 

Unknown  (The  dependence  is  unknown  (treat  as  nonlinear)) 

Note  3.2.5.1-1:  An  AC  Matrix  is  one  for  which  the  constant  component  of  the  export 
variable  depends  only  on  the  constant  component  of  the  import  variable.  The  other 
components  of  the  export  variable  can  not  depend  on  the  constant  component  of  the 
import  variable  but  are  not  restricted  in  any  other  way. 

The  addition  and  subtraction  operators  for  the  structural  Jacobian  elements  is  a 
function  of  the  manner  in  which  the  system  variables  are  represented.  For  all  of  the 
methods  used  in  this  thesis,  the  following  definitions  apply: 
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I  +  1  =  D 

1-1  =  0 

I±0  =  I 

-I±0  =  D 

-I-I  =  D 

±#t  ±m  =  ±m  ±n  =  n  (n>m,  n^T) 

U>N>A>L>D>I>0 

Note,  the  Identity  Code  I,  is  not  strictly  necessary  and  if  eliminated  simplifies  the 
addition  and  subtraction  operators  to: 

±n  ±m  =  ±m  ±n  =  n  (n>m) 

Before  the  system  structural  jacobain  can  be  constructed,  the  system  variables  and 
equations  must  be  ordered.  The  first  np  variables  are  the  node  potentials  of  the  normal 
and  information  nodes  arranged  in  the  order  of  the  node  serial  numbers.  The  next  nf 
variables  are  the  import  flow  variables  ordered  first  by  device  then  by  device  terminal. 
The  first  nn  equations  conform  to  the  Kirchhoff  Current  Law  equations  for  the  normal 
nodes  arranged  in  order  of  the  node  serial  numbers.  The  remaining  nv  equations  are  the 
potential  equations  for  the  export  potentials  ordered  first  by  the  node  serial  number  they 
are  attached  to,  then  by  the  order  of  the  devices  attached  to  the  node,  and  finally  by  the 
order  of  the  terminals  in  the  device. 

The  system  structural  Jacobian  is  constructed  in  two  parts  after  being  initialized  to 
contain  only  0.  First,  a  Kirchhoff  Current  Law  equation  is  generated  for  each  normal 
node.  The  normal  terminals  of  the  normal  nodes  are  examined  one  at  a  time.  If  the  flow 
variable  is  an  import  variable,  it  is  also  a  system  variable  and  an  /  is  added  to  the 
corresponding  element  of  the  system  Jacobian  matrix.  If  the  flow  variable  is  an  export 
variable,  its  corresponding  row  of  the  device  structural  Jacobian  matrix  is  extracted.  The 
columns  of  the  device  structural  matrix  row  correspond  to  the  device  import  variables. 
All  of  the  device  import  variables  can  be  associated  to  either  a  node  potential  (one  of  the 
first  np  columns  of  the  system  structural  Jacobian)  or  to  one  of  the  remaining  rij  import 
flow  variable  columns.  Hence  it  is  quite  easy  to  locate  to  which  column  each  element  of 
the  device  structural  Jacobian  row  must  be  added.  If  GmiH  is  non-zero  for  the  node,  a  D 
code  is  added  to  the  column  corresponding  to  the  node  potential. 
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The  remaining  nv  rows  of  the  system  structural  Jacobian  matrix  are  constructed  by 
examining  each  node  one  at  a  time.  If  the  node  has  an  export  potential  associated  with  it. 
An  /  is  added  to  the  corresponding  node  potential  column  and  potential  equation  row 
element  (unless  of  course  the  node  is  a  reference  node  and  does  not  have  a  column 
associated  with  its  potential).  The  row  of  the  device  structural  Jacobian  matrix 
corresponding  to  the  export  potential  is  then  extracted.  In  exactly  the  same  manner  as 
described  above  for  the  export  flow  variables,  the  columns  of  the  system  structural 
Jacobian  matrix  are  correlated  to  the  columns  of  the  device  structural  Jacobian  matrix. 
Once  correlated,  the  elements  of  the  device  structural  Jacobian  row  are  subtracted  from 
the  appropriate  elements  of  the  system  structural  Jacobian  matrix.  If  R,^,  is  non-zero  for 
the  node  and  the  terminal  having  the  export  potential  has  an  import  flow  variable,  then  a 
D  is  added  to  the  column  corresponding  to  the  import  flow  flow  variable.  If  Rmin  is 
non-zero  for  the  node  and  the  terminal  having  the  export  potential  has  an  export  flow 
variable,  then  a  D  is  multiplied  by  the  elements  of  the  corresponding  row  of  the  device 
structural  Jacobian  matrix  before  being  added  to  the  corresponding  column  in  the  system 
structural  Jacobian  matrix. 

Once  the  structural  Jacobian  matrix  has  been  constructed  it  can  be  examined  to 
ensure  there  are  no  glaring  problems  such  as  a  row  or  column  containing  only  0  elements. 
If  a  row  or  column  contains  only  0  elements,  the  system  is  ill -posed  and  can  not  be 
solved. 

3.2.5.2  Blocks 

The  primary  reason  for  constructing  the  system  structural  Jacobian  matrix  is  to 
break  down  the  system  of  equations  and  system  variables  into  smaller  blocks  which  can 
be  sequentially  solved  instead  of  solving  the  entire  system  at  once.  A  block  Bt  is  defined 
as  nbi  system  variables  and  nbi  equations  which  only  depend  on  system  variables  of  the 
present  block  and  previous  blocks  in  the  sequence.  A  block  of  size  ww  is  identified  by 
finding  nbi  rows  in  the  system  structural  Jacobian  matrix  that  have  not  already  been 
allocated  to  a  block  and  have  exactly  nbi  columns  containing  non-0  elements.  Of  the 
many  combinations  of  blocks  which  can  be  found  for  a  system,  the  best  combination 
contains  the  largest  number  of  small  blocks.  Here  is  an  algorithm  for  finding  the  blocks: 

1 .       Create  a  list  for  each  row  containing  the  number  of  unallocated  non-0  entries 
in  that  row.  (Initially  all  the  rows  and  columns  are  unallocated) 
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2.  Examine  the  list  for  rows  having  only  1  unallocated  non-0  entries.  Create  a 
block  for  each  of  these  rows  and  their  associated  columns.  Mark  the  rows  and 
columns  as  allocated. 

3.  Update  the  list  of  unallocated  non-0  entries  in  each  row. 

4.  Continue  steps  2  and  3  until  no  more  single  rows  can  be  allocated. 

5.  Examine  the  list  for  two  rows  only  having  unallocated  non-0  entries  in  the 
same  two  columns.  Create  a  block  for  each  pair  of  rows  and  their  associated 
columns.  Mark  the  rows  and  columns  as  allocated. 

6.  Update  the  list  of  unallocated  non-0  entries  in  each  row. 

7.  Repeat  steps  2-6  until  no  more  single  row  and  double  row  blocks  can  be 
identified. 

8.  Examine  the  list  for  three  rows  only  having  unallocated  non-0  entries  in  the 
same  three  columns.  Create  a  block  for  each  set  of  three  rows  and  their 
associated  columns.  Mark  the  rows  and  columns  as  allocated. 

9.  Update  the  list  of  unallocated  non-0  entries  in  each  row. 

10.  Repeat  steps  2-9  until  no  more  blocks  of  up  to  size  3  can  be  identified. 

11.  Continue  the  above  algorithm  until  all  of  the  rows  and  columns  have  been 
allocated.  Remember  it  is  necessary  to  go  back  and  attempt  to  identify 
smaller  sized  blocks  after  discovering  a  larger  block  since  the  removal  of  a 
column  could  allow  the  identification  of  a  new  smaller  block. 

The  order  of  identifying  blocks  is  very  important  because  they  must  be  solved  in  the 
same  order.  Each  block  contains  the  same  number  of  system  variables  and  system 
equations.  The  equations  only  depend  on  system  variables  determined  from  the  present 
and  previous  blocks.  Hence  the  simulation  problem  becomes  an  issue  of  solving 
sequences  of  relatively  small  systems  of  equations  described  by  blocks. 

3.2.6  Reduced  System 

The  reduced  system  consists  of  the  sequence  of  blocks  which  when  solved,  provide 
the  solution  for  all  the  system  variables.  Solving  each  of  the  blocks  can  be  done  a  number 
of  ways.  Most  schemes  start  with  an  initial  guess  for  the  system  variables  and  generate 
corrections  to  the  guesses  until  all  of  the  system  equations  for  that  block  are  satisfied. 
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Generating  the  corrections  is  normally  done  through  the  use  of  a  block  Jacobian  matrix 
which  can  be  constructed  in  much  the  same  manner  as  the  system  structural  Jacobian.  If 
the  block  structural  Jacobian  does  not  contain  any  A,  N  or  U  elements,  the  block  Jacobian 
can  be  inverted  and  multiplied  by  the  system  equation  errors  to  provide  the  required 
corrections.  If  there  are  any  nonlinearities,  this  scheme  can  be  performed  several  times 
until  the  system  equation  errors  are  close  to  zero.  This  method  is  commonly  referred  to  as 
the  Newton-Raphson  method  and  if  the  initial  guess  is  close  enough  to  the  solution,  the 
method  converges  quadratically.  This  method  is  described  in  much  more  detail  in  section 
3.4.1. 

Relaxation  techniques  can  also  be  used  to  calculate  the  system  variables.  Relaxation 
techniques  start  with  an  initial  guess  for  all  of  the  system  variables  and  update  each 
variable  one  at  a  time  by  solving  a  single  system  equation  by  assuming  all  of  the  other 
variables  are  constant.  Typically,  one  system  equation  is  assigned  the  task  of  solving  for  a 
particular  system  variable.  With  careful  thought  as  to  the  assignment  of  variables  to 
equations,  it  is  often  possible  for  such  a  system  to  converge  to  a  solution.  Common 
relaxation  techniques  are  the  Gauss-Seidel  and  Gauss-Jacobi  methods. 
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3.3  Waveforms 

Up  to  this  point,  the  development  of  the  simulation  structure  has  been  independent  of 
the  manner  in  which  variables  are  actually  described.  The  simplest  and  most  commonly 
used  method  for  representing  variables  is  through  a  single  real  number  representing  the 
value  of  a  variable  at  a  specific  time.  For  static  simulations  where  the  problem  is  to  obtain 
the  steady  state  solution  for  the  system,  this  method  works  very  well.  Appendix  C  and 
Appendix  D  demonstrate  this  procedure  for  the  classic  load  flow  problems.  For  dynamic 
simulations  however,  some  knowledge  as  to  the  time  history  of  the  variables  is  needed  to 
calculate  derivatives  and  integrals.  A  dynamic  simulation  is  implemented  as  a  series  of 
static  simulations  where  the  dynamics  are  represented  by  functions  of  the  time  increment 
and  state  variables.  The  various  integration  techniques  for  this  type  of  simulation  differ 
only  in  the  interpolation  scheme  used  to  approximate  the  variables  between  successive  static 
simulations.  The  time  increment  between  static  simulations  must  be  carefully  controlled  to 
ensure  the  interpolation  scheme  has  enough  accuracy  for  numerical  stability.  Integration  in 
this  manner  requires  careful  control  of  the  time  increment  to  ensure  the  interpolation 
scheme  is  accurate  enough  to  ensure  numerical  stability  along  with  an  accurate  solution. 

Another  approach  to  representing  variables  is  the  waveform.  This  method  employs  a 
vector  of  coefficients  to  continuously  describe  the  time  domain  value  of  the  variable  over 
some  time  interval  [t^t^.  The  type  of  the  waveform  determines  how  the  coefficients  are 
interpreted  to  generate  the  time  domain  values.  Possible  types  include  Data  Series,  Fourier 
Series,  Legendre  Series,  Polynomial  Series  and  Legendre  Series.  The  principal  advantages 
of  using  waveforms  over  discrete  points  include: 

1.  Interpolation  is  not  generally  required  to  determine  intermediate  points.  The 
value  of  a  variable  can  readably  be  determined  for  any  time. 

2.  The  numerical  stability  of  Integration  and  Differentiation  techniques  do  not 
have  to  depend  on  the  time  step  control  since  integration  and  differentiation 
become  waveform  operators  on  an  equal  level  to  all  other  operators.  Time  step 
control  becomes  only  an  issue  of  numerical  accuracy  and  not  of  numerical 
stability. 

3.  Certain  operations  may  be  easier  to  perform  with  one  waveform  type.  The 
ability  to  efficiently  convert  a  waveform  from  one  type  to  another  type  and 
back  again  allows  one  to  use  the  most  efficient  waveform  type  in  the 
calculations  of  a  given  operator. 
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3.3.1  Waveform  Definition 

A  waveform  approximates  the  instantaneous  value  of  a  variable  over  some  time 
interval.  The  elements  of  information  contained  within  a  waveform  must  as  a  minimum 
include: 

1 .  The  name  of  the  waveform 

2.  The  beginning  and  ending  times  of  the  interval  (t0 ;,) 

3.  An  Array  of  Coefficients  representing  the  waveform  (c,) 

4.  The  number  of  coefficients  in  the  Coefficient  Array  (n) 

5.  A  waveform  type  indicator. 

The  waveform  type  indicator  identifies  how  the  coefficients  should  be 
interpreted  when  operations  are  performed  on  the  waveform.  Here  is  an  example  of  a  C 
structure  defining  a  Waveform: 

typedef  struct  Waveform 
{ 

char    *name;   /*  character  string  of  the  name 

of  the  variable  */ 
double     tO;   /*  time  of  the  beginning  of  the  interval  */ 
double     tl;   /*  time  of  the  end  of  the  interval  */ 
void       *c;   /*  array  of  coefficients  */ 
long        n;   /*  number  of  elements  in  the  array  */ 
long     type;   /*  waveform  type  indicator  */ 
long  version;   /*  Version  of  this  waveform  */ 

struct  Waveform  *next;   /*  pointer  for  forward 

linked  lists  */ 
struct  Waveform  *last;   /*  pointer  for  backwards 

linked  lists  */ 
struct  Jacobian  *jnum;   /*  pointer  to  linked  list  of 

jacobians  where  this  waveform 

is  the  numerator  */ 
struct  Jacobian  *jden;   /*  pointer  to  linked  list  of 

jacobians  where  this  waveform 

is  the  denominator  */ 
} 
WAVEFORM; 

The  above  definition  also  includes  the  following  optional  information: 

6.  A  Version  Number  to  record  a  change  in  the  waveform's  properties. 

7.  An  Address  Pointer  to  the  waveform  representing  the  previous  time  interval. 

8.  An  Address  Pointer  to  the  waveform  representing  the  following  time  interval. 

9.  An  Address  Pointer  to  a  linked  list  of  Jacobian  Structures. 
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The  waveform  address  pointers  allow  one  to  construct  a  linked  list  of  waveforms  to 
describe  the  time  history  of  a  variable  over  a  number  of  time  intervals.  The  Jacobian 
structure  as  well  as  the  version  number  will  be  described  in  section  3.3.3. 

Note  the  waveform  coefficients  are  declared  to  be  of  type  void.  This  is  done  to  allow 
for  the  coefficients  to  be  abstract  data  representations  in  themselves.  Normally  the 
waveform  coefficients  would  be  double  precision  floating  point  numbers,  but  it  should  also 
be  possible  to  incorporate  other  types  of  data.  It  may  be  advantageous  for  example,  to 
represent  the  coefficients  with  complex  numbers.  In  this  case,  each  element  in  the 
coefficient  array  would  be  a  structure  holding  double  precision  floating  point  numbers 
corresponding  to  the  real  and  imaginary  parts  (Or  magnitude  and  phase  angle)  of  the 
complex  number. 
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3.3.2  Waveform  Operators 

Waveform  Operators  are  functions  which  act  on  waveform  arguments  to  generate 
new  waveforms,  or  provide  some  information  about  the  waveform  arguments.  The  types 
of  functions  can  be  broken  down  into  several  groups: 

1.  Arithmetic  Operators 

2.  Trigonometric/Exponential  Operators 

3.  Switching  Operators 

4.  Integral/Differential  Operators 

5.  Waveform  Content 

6.  Special  Functions 

3.3.2.1  Arithmetic  Operators 

The  arithmetic  operators  are  the  customary  addition,  subtraction,  multiplication, 
division,  and  assignment  operators  usually  associated  with  floating  point  arithmetic.  The 
assignment  operator  is  a  bit  more  complex  since  it  must  incorporate  waveform  type  and 
number  of  coefficient  conversions. 

3.3.2.2  Trigonometric/Exponential  Operators 

The  Trigonometric/Exponential  operators  include  most  of  the  transcendental 
functions  used  in  engineering.  Examples  include  sine,  cosine,  tangent,  logarithms, 
exponentials,  as  well  as  the  inverse  functions.  Error  handling  can  become  quite  complex 
since  several  of  these  operators  may  be  undefined  at  one  or  more  points  within  the 
argument  waveform.  These  operators  are  usually  handled  by  converting  the  arguments  to 
a  series  of  data  points,  performing  the  operation  point  by  point,  and  then  converting  back 
to  the  appropriate  waveform  type. 

3.3.2.3  Switching  Operators 

Switching  Operators  are  operators  producing  waveforms  which  themselves  or  one 
of  their  derivatives  are  discontinuous.  Examples  include  the  absolute  value  function,  the 
sign  function  and  the  step  function.  The  typical  method  for  calculating  these  functions  is 
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to  determine  the  discontinuity  points  and  use  integration  to  create  a  characteristic  function 
series  solution  (e.g.  Legendre  Series  or  Chebyshev  Series)  for  the  result.  The  series 
solution  is  then  converted  to  the  appropriate  waveform  type. 

3.3.2.4  Integral/Differential  Operators 

One  of  the  key  advantages  of  using  waveforms  in  dynamic  simulations  is  that 
integration  and  differentiation  become  very  simple  operators  where  the  stability  of  a 
numerical  integration  scheme  is  generally  not  an  issue.  For  many  waveform  types,  the 
integration  operator  is  a  linear  matrix  operation  with  bounded  coefficients.  If  the 
argument  waveform  has  bounded  coefficients,  the  returned  waveform  will  also  be 
bounded.  Of  course,  numerical  stability  does  not  assure  numerical  accuracy.  Because  the 
integration  operator  typically  generates  some  truncation  error,  the  returned  waveform  can 
still  contain  considerable  errors. 

3.3.2.5  Waveform  Content 

The  significance  of  the  Truncation  Error  of  a  waveform  can  be  estimated  by 
calculating  the  waveform  content  of  its  higher  order  term.  The  waveform  content  of  a 
term  is  defined  as  the  magnitude  of  a  coefficient  divided  by  the  square  root  of  the  sum  of 
the  squares  of  all  the  coefficients.  Normally,  one  expects  the  higher  order  terms  of  an 
orthogonal  series  representation  to  progressively  have  smaller  and  smaller  waveform 
contents.  Hence  if  the  last  few  terms  have  values  below  a  preset  threshold,  the  truncation 
error  can  normally  be  assumed  negligible. 

Accurate  truncation  error  estimation  is  still  a  difficult  and  currently  unsolved 
research  topic.  The  waveform  content  method  is  a  practical  method  but  should  not  be 
taken  as  the  last  word  on  the  subject. 

3.3.2.6  Special  Operators 

Several  special  operators  unique  to  waveforms  should  also  be  developed.  One  very 
useful  operator  returns  the  time  of  zero  crossing  of  the  waveform.  Another  returns  the 
value  and  time  of  every  local  minimum  and  maximum  of  a  waveform. 

The  smoothing  operator  is  one  method  for  reducing  the  waveform  content  of 
higher  order  coefficients.  A  waveform  is  smoothed  by  returning  the  local  average  of  the 
waveform  over  some  prespecified  time  increment.    Smoothing  eliminates  discontinuities 
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in  a  waveform  and  its  derivatives.  Since  discontinuities  tend  to  amplify  the  waveform 
content  of  the  higher  order  terms,  removing  the  discontinuities  should  reduce  the  higher 
order  term  waveform  content. 
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3.3.3  Jacobians 

A  Jacobian  matrix  contains  the  partial  derivatives  of  the  coefficients  of  one 
waveform  with  respect  to  another  waveform.  Here  is  a  sample  C  structure  to  define  a 
Jacobian: 


typedef  struct  Jacobian 


{ 


struct  Waveform  *num; 

struct  Waveform  *den; 

long  version; 
long  num  version; 
long  den_version; 
void  **j; 

char  sj; 


/*  address  of  waveform  in  the 
numerator  of  the  partial 
derivatives  */ 

/*  address  of  waveform  in  the 
denominator  of  the  partial 
derivatives  */ 
/*  Version  number  of  the 

jacobian  matrix  */ 
/*  Version  nbr  of 

numerator  Waveform  */ 
/*  Version  nbr  of 

denominator  Waveform  */ 
/*  array  of  jacobian  elements 

The  first  row  index  is  for 
an  array  of  pointers  whose 
elements  are  arrays  with 
the  colum  index  */ 
/*  Structural  Jacobian  Code  */ 


struct  Jacobian  *next;   /*  address  for  linked  list 

of  Jacobians  */ 


} 


JACOBIAN; 

Jacobians  are  used  in  the  process  of  solving  simultaneous  systems  of  waveform 
equations  through  relaxation  methods  or  through  the  Newton-Raphson  Method.  The 
purpose  of  num_version  and  den_version  is  to  record  which  versions  of  the  numerator 
and  denominator  waveforms  the  jacobian  was  calculated  for.  The  element  version  is  used 
when  several  jacobians  are  combined  and  it  is  necessary  to  determine  whether  the 
combined  matrix  must  be  recalculated. 

In  general,  all  operations  defined  for  a  waveform  should  also  generate  the  jacobian  of 
the  results  with  respect  to  the  arguments.  Through  the  use  of  the  chain  rule,  the  jacobian 
matrix  of  the  export  variables  of  a  device  with  respect  to  the  device  import  variables  can  be 
determined. 

The  Structural  jacobian  code  indicates  the  dependence  and  structure  of  the 
jacobian  matrix.  Here  is  a  list  of  the  codes: 
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Code 

Type  of  Matrix 

0 

Zero  Matrix  (all  elements  are  always  zero) 

I 

Identity  Matrix  (always  the  identity  matrix) 

D 

Diagonal  Matrix  (always  a  linear  main  diagonal  matrix) 

L 

Linear  Matrix  (The  elements  are  always  constant) 

N 

Nonlinear  Matrix  (The  elements  may  not  be  constants) 

U 

Unknown  (The  dependence  is  unknown  (treat  as  nonlinear)) 

The  structural  jacobian  code  along  with  the  version  numbers  determines  whether  or 
not  a  jacobian  matrix  needs  to  be  recalcuated.  If  the  structural  jacobian  is  of  type  0,  I,  D, 
or  L  then  the  jacobian  need  not  be  reconstructed  if  the  there  is  a  version  mismatch  between 
the  waveform  version  and  the  jacobian  version.  If  the  structural  jacobian  of  type  N  or  U, 
and  there  is  a  mismatch  between  the  version  numbers  of  the  jacobian  and  the  waveforms, 
then  the  jacobian  elements  must  be  recalculated.  After  every  recalculation,  the  version 
numbers  are  updated.  In  this  manner,  only  jacobian  matrices  with  changing  coefficients 
are  ever  recalculated. 

Technically,  the  structural  jacobian  codes  depend  on  the  waveform  type  used.  In  this 
thesis  however,  all  of  the  waveform  types  produce  the  same  structural  jacobian  codes. 

3.3.3.1  Jacobian  Operators 

Several  operators  for  jacobian  objects  will  prove  useful  in  developing  a  simulation 
environment.  These  operators  include: 

1.  Addition  and  Subtraction 

2.  Identity  and  Zero  Jacobian  generators 

3.  Multiplication  by  a  constant 

4.  Multiplication  of  two  jacobians 

5.  Multiplication  of  a  jacobian  by  a  waveform 

6.  Inverting  a  jacobian 

If  the  waveform  is  described  by  an  array  of  double  precision  floating  point  numbers, 
the  Jacobian  coefficients  can  also  be  defined  to  be  an  array  of  double  precision  floating 
point  numbers.  In  this  case,  the  above  operations  employ  standard  matrix  manipulations. 
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3.3.4  Waveform  Examples 

While  the  possibilities  of  waveform  definitions  is  endless,  this  thesis  will  concentrate 
on  the  following  waveform  types: 


Waveform  Type 

Code 

Undefined 

0 

Data  Series 

1 

Fourier  Series 

2 

Legendre  Series 

3 

Polynomials 

4 

Matlab  Polynomials 

5 

Chebyshev  Series 

6 

The  code  in  the  above  table  refers  to  the  value  of  element  type  in  the  WAVEFORM 
structure.  Appendix  E  describes  these  waveforms  and  their  arithmetic  in  great  detail. 
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3.4  Conducting  the  Simulation 

Once  the  physical  system  has  been  specified  by  device  descriptions  and  network 
equations,  the  solution  for  all  of  the  system  variables  can  be  determined  in  several  ways. 
The  method  used  in  this  thesis  is  the  Newton-Raphson  method  with  continuation 
parameters. 

3.4.1  Basic  Newton-Raphson  Algorithm 

The  Newton-Raphson  method  solves  a  system  of  nonlinear  equations  F(x,u)  =  0, 
FQ  e  9T,  for  the  system  variables  x  e  9T  with  system  input  variables  u  e  9^mby  first 
linearizing  the  system  of  equations  about  a  given  guess  for  the  solution  xk  then  solving  the 
linear  system  to  produce  a  new  guess  xk+1.  This  procedure  is  repeated  until  F(xk,u)  =  0  is 
satisfied  within  a  given  tolerance.  The  sequence  of  points  xk  starting  with  k  =  0  is  called 
the  solution  trajectory  for  x°.  A  converging  solution  trajectory  eventually  converges  to  a 
solution  while  a  diverging  solution  trajectory  does  not. 

F(x,u)  is  linearized  by  taking  the  Taylor  series  expansion  about  the  point  xk: 
F(x,u)  =  F(xk,u)+J(xk,u)x^  +  O(xx)  =  0 
x  =x  +xA 


where  the  Jacobian  matrix  J(x^u)  is  defined  by: 


0          dF(x°,u) 
J(x  ,u)  =  — 


Assuming  the  error  0(x»x)  is  negligible  and  the  Jacobian  can  be  inverted,  the 
correction  *A  for  a  given  guess  x*  is  given  by  the  linear  approximation: 


x&  =  -J   (x  ,u)x 

The  correction  is  applied  to  x*  to  produce  x*+1,  the  value  of  x  for  the  next  iteration: 

*+i       *  . 
x      =x  +xA 

Around  each  solution  of  F(x,u)  =  0  for  which  the  Newton-Raphson  method  reliably 
converges,  a  region  exists  such  that  if  a  trajectory  enters  that  region,  it  will  never  leave  and 
eventually  converge  to  the  solution.  The  size  of  this  local  convergence  region  depends  on 
the  nonlinearity  of  the  system.    For  purely  linear  systems,  this  region  encompasses  the 
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entire  <Rn  space.  If  the  intitial  guess  falls  within  the  local  convergence  region,  the 
Newton-Raphson  method  will  by  definition  converge.  If  the  initial  guess  falls  outside  the 
local  convergence  region,  one  of  several  things  can  happen.  First,  the  solution  trajectory 
could  enter  the  local  convergence  region  of  a  solution  and  converge  on  a  solution.  Second, 
the  Newton-Raphson  method  could  fail  due  to  a  singular  Jacobian.  Third,  the  trajectory 
could  diverge  and  tend  to  infinity.  Fourth,  the  trajectory  could  become  cyclic  where 
xk+*  =  xk  for  k  sufficiently  large  enough.  Finally,  the  trajectory  could  enter  a  chaotic  region 
in  which  there  is  no  solution  but  from  which  the  trajectory  never  leaves  and  is  not  cyclic. 

As  an  example,  define  F(x,u)  to  be  the  following  lxl  system: 

F(x,u)  =  x3  -x 
Figure  3.4.1-1:  F(x,u)  =  x3-x 


10 


10 


1 
1 

4 

Regions 
2 

5          3                            / 

/ 

5x*-1 

Region  1:  -1 
Region  2:  0 
Region  3:  1 
Region  4:   1 
Region  5:  -1 

3x'-1 

The  Jacobian  matrix  is: 


J  =  [3x2-l) 


k+l 


The  recursion  formula  for  x     is  given  by: 


*+,       *     (xkf-xk 
x      =x — 

3(**)2-l 
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There  are  three  solutions  for  this  system  and  their  local  convergence  regions  are 
given  by: 


Root 

Local  Convergence  Region 

*i  =  -l 

w<-vr 

x2=  0 

-vp<vt 

*3=+l 

VR<~ 

In  two  other  regions,  the  solution  trajectory  jumps  to  one  of  the  local  convergence 
regions  after  one  iteration: 


Root 

Convergence  Region 

*i  =  -l 

0.46560  <x°<^^  =  0.57735 

x3  =  +1 

-a/ -  =  -0.57735  <x°< -0.46560 

In   two   other  regions,    the   solution   trajectory   may  jump   to   one   of  the   local 
convergence  regions  after  several  iterations  or  fail  to  converge: 


Variable  Behavior  Region 


#o 


44721  <x°<  0.46560 


-0.46560  <  x 


•<-VT- 


=  -0.44721 


On  the  boundaries  for  the  above  regions,  the  Newton-Raphson  method  fails: 
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x° 

Failure  Mode 

Wl 

Singular  Jacobian 

±0.46560 

Singular  Jacobian 

WT 

Cyclic  Trajectory 

In  the  above  analysis,  no  constraints  were  made  in  the  speed  of  convergence  or  on 


the  size  of  x.   If  |  xk  |»  1  the  speed  of  convergence  will  be  very  slow  since  x 
the  number  of  iterations  /  required  will  be  about: 

log(|**  |) 


*  +  i 


=  jx*  and 


/-*  = 


log(l. 5) 


«  5.68  log(|;c*  |) 


Furthermore,  most  machines  have  a  limit  as  to  the  largest  number  which  can  be 
represented.  If  an  iteration  causes  jc  to  exceed  this  number  in  magnitude,  a  floating  point 
overflow  error  will  typically  be  generated.  This  phenomena  is  known  as  Newton  Overflow 
and  has  the  effect  of  reducing  the  size  of  the  convergence  regions.  For  example,  if  or  is 
known  to  be  bounded  by  the  interval  [-10  10],  then  jc°  should  be  restricted  to  the  following 
regions: 


Root 

Convergence  Region 

*i  =  -l 

-10  <  x°  <  -0.58904 
0.46560  <*0<  0.56675 

x2  =  0 

-A/ -  =  -0.44721  <Jt°<-\/-  =  0.44721 

x3  =  +l 

-0.56675  <  x°  <  -0.46560 
0.58904  <  a0  <  10.0 
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3.4.2  Continuation  Methods  with  Newton-Raphson 

The  previous  discussion  indicates  the  need  for  careful  selection  of  the  initial  guess  x°. 
The  use  of  a  continuation  parameter  in  so  called  hornotopy  methods  is  one  of  the  many 
ways  for  attempting  to  generate  x°  within  the  convergence  region  of  the  desired  solution. 
In  general,  a  function  H(x,u,a)  -  0  is  generated  such  that  H(x,u,l)  =  F(x,u)  and 
H(x,u,0)  =  G(x,u)  where  G(x,u)  is  a  linear  function  in  x.  One  common  method  of  creating 
H(x,u,a)  is: 

H(x,u,a)  =  aF(x,u)  +  (l  -a)G(x,u) 

The  problem  now  is  to  develop  the  linear  function  G(x,u).  There  are  several 
approaches  which  can  be  taken  for  each  row  G,(x,w): 

1.  Linearize  about  a  known  operating  point.  This  is  equivelent  to  providing  an 
initial  guess  for  each  of  the  variables  and  using  the  Newton-Raphson  method 
directly. 

2.  Use  a  least  squares  fit  of  a  linear  system  over  a  known  operating  region  of 
F,{x,u). 

3.  Select  G,{xyu)  such  that  the  solution  for  H(x,uy0)  -  0  is  most  likely  to  be  within 
the  convergence  region  of  F(x,u). 

Once  /7(;t,i/,a)  has  been  constructed,  it  can  be  used  in  several  ways: 

1.  Start  with  oc=0  and  obtain  a  solution  to  the  linear  system,  then  progressively 
increment  alpha  by  small  amounts  and  solve  the  nonlinear  system  until  a=l.  The 
rational  is  to  employ  the  unbounded  local  region  of  convergence  of  the  linear  system 
to  move  the  initial  guess  into  the  local  region  of  convergence  for  the  next  nonlinear 
system  formed  by  incrementing  a.  As  a  is  incremented,  the  solution  for  the  previous 
value  of  a  is  assumed  to  be  within  the  local  region  of  convergence  for  the  present 
value  of  alpha.  Appendix  B  demonstrates  this  may  not  always  happen  due  to 
bifurcations  of  solutions  as  a  is  incremented. 

2.  Start  with  a=l  and  attempt  to  obtain  a  solution  to  the  nonlinear  solution.  If  the 
trajectory  has  not  converged  after  nmax  iterations,  decrement  a  and  attempt  to  find  a 
solution.  Progressively  decrement  a  until  a  solution  is  obtained,  then  increment  a 
using  the  solution  of  the  previous  value  for  a  for  the  initial  guess.  This  procedure 
assumes  the  local  convergence  region  for  a  given  solution  will  increase  as  a  is 
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decremented.  Eventually  the  local  convergence  region  should  grow  large  enough  to 
encompass  even  a  poor  guess  for  the  solution.  This  procedure  has  the  advantage  over 
the  previous  method  in  that  it  may  avoid  bifurcations  which  occur  between  0  and  the 
minimum  value  for  a  used.  However,  the  number  of  iterations  for  a  may  be  larger. 

Note  that  the  value  for  nmax  as  well  as  the  convergence  criteria  may  be  a  function  of 
a.  There  is  no  reason  to  obtain  a  highly  accurate  solution  for  intermediate  values  of  a 
since  the  only  purpose  is  to  move  the  initial  guess  for  the  next  a  iteration  into  the  new 
local  region  of  convergence.  Only  when  a=l  should  the  convergence  criteria  be  enforced 
for  obtaining  a  highly  accurate  solution. 
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3.4.3  Simulation  Algorithm 

The  simulation  algorithm  employed  by  WAVESIM  is  conducted  totally  within  the 
MATLAB  environment  and  is  composed  of  four  parts.  The  first  part  initializes  all  of  the 
simulation  parameters.  The  second  part  performs  the  time  increment  control  and  has 
embedded  with  in  it  the  third  part  which  is  the  sequential  solving  of  each  of  the  blocks. 
The  final  part  is  composed  mostly  of  plotting  and  storing  the  results  of  the  simulation. 

Figure  3.4.3-1:  Simulation  Flowchart 
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3.4.3.1  System  Initialization 

A  number  of  parameters  and  arrays  need  initialization  before  the  simulation  can 
commence.  These  parameters  and  arrays  are: 

Initial  number  of  waveform  coefficients 
Actual  number  of  waveform  coefficients  used 

Waveform  type  indicator 

Beginning  time  of  simulation 
Ending  time  of  simulation 

Minimum  number  of  coefficients  to  use 
Maximum  number  of  coefficients  to  use 

Number  of  points  per  waveform  for  plots 

Initial  time  increment 
Optimum  time  increment 

Minimum  time  increment 
Maximum  time  increment 

Minimum  time  of  interest  (Averaging  interval) 

Break  Points  are  user  specified  times  for  which  waveform  interval  boundaries  are 
forced  to  occur.  Break  Points  are  completely  optional  and  their  inclusion  is  up  to  the 
system  modeler. 

sb_bp  Array  of  Break  Points 

sb_bp_nbr  Number  of  break  points 

sys_node_serial         Array  of  Node  Serial  Numbers 
sys_node_name  Array  of  Node  Names 

sb_alpha_init  Initial  Value  of  continuation  parameter  alpha  for  nonlinear 

blocks 
sb_dalpha_init  Initial  Value  of  alpha  increment 

sb_dalpha_min  Minimum  alpha  increment 

sb_dalpha_max  Maximum  alpha  increment 

sys_Gmin  Array  of  Gmin  values  for  all  of  the  nodes 

sys_Rmin  Array  of  Rmin  values  for  all  of  the  nodes 

The  index  for  sys_Gmin  and  sys_Rmin  are  the  node  numbers  of  the  nodes  they 
apply  to. 
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to. 


sb  check_eqn_err 
sb_check_var_err 

sys_kcl_err 
sys_pot_err 

sys_nd_err 
sys_fv_err 

sb_i_kcl_err 
sb_i_pot_err 

sb_i_nd_e  r  r 
sb  i  fv  err 


=  0  for  don't  check  equation  error 

=  1  for  checking  equation  error 

=  0  for  don't  check  max  variable  correction 

=  1  for  checking  max  variable  correction 

Array  of  maximum  KCL  errors  for  all  nodes 

Array  of  maximum  Potential  Differences  for  all  nodes 

Array  of  max  corrections  to  Node  Potentials  for  all  nodes 
Array  of  max  corrections  to  Flow  Variables  for  all  nodes 

Multiplier  for  maximum  KCL  error 

for  alpha  less  than  1 
Multiplier  for  maximum  Potential  Difference 

for  alpha  less  than  1 

Multiplier  for  max  correction  to  node  potential 

for  alpha  less  than  1 
Multiplier  for  max  correction  to  flow  variable 

for  alpha  less  man  1 


The  index  for  the  above  eight  arrays  are  the  node  numbers  of  the  nodes  they  apply 


sb_maxcnt 
sb  i_maxcnt 

sb_di  v_st  art_cnt 
sb  div_max_cnt 

sb_i_di v_e  r r 

sb_max_wc 
sb_nbr_wc 
sb  mult_wc 

sys_pot_scale 
sys  flow_scale 


Maximum  number  of  iterations  for  alpha  =  1 
Maximum  number  of  iterations  for  alpha  <  1 

Number  of  iterations  to  skip  before  checking 

for  divergence 
Maximum  number  of  diverging  iterations  before 

assume  system  is  diverging 
Multiplier  of  errors  for  ignoring  diverging  check 

Maximum  waveform  content  of  a  waveform 
Number  of  coefficients  to  apply  waveform  content  to 
Multiplier  to  sb_majc_wc  for  decrementing  n 

Array  of  Scaling  factors  for  node  potentials 

Array  of  Scaling  factors  for  flows  attached  to  nodes 


The  index  for  sys_pot_scale  and  sys_f  iow_scaie  are  the  node  numbers  of  the 
nodes  they  apply  to. 


dev_par_name 
dev  sO  name 


Device  parameter  arrays:  name  is  the  device  name 
Device  state  initial  value  array: 
name  is  the  device  name 
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ivar  nd  nbr 


ivart  nd  nbr 


ivar  fv  name 


ivart  fv  name 


his  t 


his  N 


his  col 


his  nd  nbr 


his  fv  name 


his  s  name 


blk  nbr_nrow 
blk_nbr_ncol 
blk_nbr_row_sys 
blk  nbr  col  sys 


Initial  guesses  for  node  potentials: 

nbr  is  the  node  serial  number 
Waveform  type  for  initial  guess 

nbr  is  the  node  serial  number 
Initial  guess  for  flow  variables: 

name  is  the  variable  name 
Waveform  type  for  initial  guess 

name  is  the  variable  name 

Matrix  of  time  increment  end  points 
First  row  is  beginning  of  intervals 
Second  row  is  end  of  intervals 
Columns  are  waveform  interval  index 

Vector  of  number  of  coefficients  in  waveforms  for  each 
waveform  interval 

The  waveform  interval  index.  After  simulation  this  equals 
the  number  of  columns  in  history  arrays 

Matrix  of  Node  Potential  waveforms.  Each  column 
corresponds  to  the  waveform  for  the  node  potential  over  a 
given  waveform  interval,  nbr  is  the  node  serial  number 

Matrix  of  Import  Flow  Variable  waveforms.  Each  column 
corresponds  to  the  waveform  for  the  import  flow  variable 
over  a  given  waveform  interval,  name  is  the  variable  name 

Matrix  of  Device  name  state  values.  The  first  column 
corresponds  to  the  initial  state  values  with  subsequent 
columns  corresponding  to  the  state  values  at  the  end  of 
waveform  intervals.  Note  this  matrix  has  1  more  column 
than  all  the  other  history  arrays. 

Number  of  rows  in  block  nbr 

Number  of  columns  in  block  nbr 

Cross  Reference  of  Block  nbr  rows  to  System  Rows 

Cross  Reference  of  Block  nbr  columns  to  System  Columns 


blk  nbr  linear  flag 


=  0  if  block  nbr  is  nonlinear 
=  1  if  block  nbr  is  linear 
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Time  Increment  Initialization 

ddt  Actual  time  increment 

ttO  Beginning  of  current  waveform  interval 

ttl  End  of  current  waveform  interval 

ddt,  ttO,  and  ttl  are  initialized  according  to  the  following  equations: 

ddt    =    sb_dt_init 
ttO  =  to 

ttl  =  minimum  of: 
to  +  ddt 

tl 
sb_bp(l) 

cnt_tot  Set  to  zero:  Total  number  of  Jacobian  inverses 

his  flops  Number  of  floating  point  operations  used 
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3.4.3.2  Time  Loop 

Truncation  Error  Control 

The  simulation  time  interval  between  to  and  ti  may  be  divided  into  a  number  of 
waveform  intervals  to  improve  the  truncation  error  of  the  system  variable  waveforms.  In 
general,  truncation  error  can  be  reduced  by  either  increasing  n  or  by  decreasing  the 
waveform  interval  ttl  -  tto.  Within  WAVESEM,  the  general  strategy  for  dealing  with 
too  large  of  a  truncation  error  is  to  increase  the  number  of  coefficients  n  if  the  waveform 
interval  is  less  than  sb_dt_optimum  and  shorten  the  waveform  time  interval  if  greater 
than  sb_dt_opt i-mum.  In  general,  the  strategy  is  to  minimimize  n  while  maximizing  the 
waveform  interval  subject  to  the  constraint  that  the  truncation  error  is  within  tolerances. 
Finding  the  optimum  combination  of  waveform  intervals  and  number  of  coefficients  is 
not  obvious  and  much  work  remains  for  developing  better  algorithms. 

3.4.3.2.1  Time  Loop  iteration  initialization 

The  simulation  time  loop  continues  as  long  as  tto  <  ti.  The  beginning  of  each 
iteration  begins  with  the  definition  of  the  following  arrays: 

tt   =    [ttO   ttl    sb_dt_ave] 
ii  =  Identity  Matrix  of  size  n 
zz  =  Zero  Matrix  of  size  nxk 

Variable  Initial  Guesses 

Next,  initial  guesses  are  provided  for  all  system  variables  (var_nd_n£>r  and 

var_fv_name)  by  Converting  the  waveforms  ivar_nd_nbr  of  type  ivart_nd_n±>r  and 

waveforms  ivar_fv_name  of  type  ivart_fv_name  into  waveforms  of  type  wtype  and 
size  n. 

In  the  present  incarnation  of  WAVESIM,  the  same  waveform  is  used  as  the  initial 
guess  for  all  waveform  time  intervals  regardless  of  the  values  for  tto  and  ttl. 
Normally,  a  constant  value  is  specified.  A  better  method  would  allow  the  user  to  specify 
an  actual  guess  as  to  the  waveform  history  as  a  function  of  time.  The  time  loop  iteration 
initialization  would  then  have  the  responsibility  of  converting  the  waveform  data  as 
provided  by  the  user  into  a  waveform  of  type  wtype  and  size  n  over  the  interval  between 
tto  and  ttl.  Providing  an  initial  guess  for  the  waveform  history  of  all  the  variables 
would  allow  for  example,  a  linear  model  of  a  system  be  run  first  to  generate  the  initial 
guess  for  a  nonlinear  model  of  the  same  system.    Convergence  of  the  nonlinear  system 
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should  be  greatly  accelerated  for  many  systems.  Parameter  sensitivity  studies  would 
also  be  greatly  accelerated  if  the  parameter  variations  are  not  expected  to  cause  major 
changes  in  system  performance. 

Failure  Flags 

Two  final  variables,  converge_faiiure  and  fatai_error  are  initialized  to  zero. 
converge_f  allure  is  set  to  one  by  a  block  if  convergence  failed  for  that  block  or  if  one 
of  the  block  waveforms  has  too  large  of  a  harmonic  content.  Convergence  could  fail  if 
the  number  of  iterations  exceeded  the  maximum  allowed  and  the  alpha  increment  is 
smaller  than  the  minimum  allowed.  converge_f  allure  is  used  to  indicate  the  following 
blocks  should  not  be  solved  because  previous  blocks  could  not  be  solved,  f  atai_error 
is  set  to  one  if  convergence  cannot  be  obtained  even  when  n  is  equal  to  or  greater  than 
the  maximum  value  sb_n_max  and  the  time  increment  is  equal  to  or  smaller  than  the 
minimum  value  sb_dt_min.  If  f  atai_error  is  set,  the  simulation  fails. 
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3.4.3.2.2  Solving  the  Blocks 

The  blocks  are  solved  sequentially  in  the  order  of  their  detection  in  the  system 
reduction  procedure.  If  converge_faiiure  is  nonzero,  a  previous  block  could  not  be 
solved  for  the  given  time  increment  and  number  of  coefficients.  For  this  reason,  a  block 
is  not  solved  if  converge_f  ailure  is  nonzero. 

Figure  3.4.3-2:  Solving  the  Block 
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3.4.3.2.2.1  Block  Initialization 

Each  block  requires  the  initialization  of  several  arrays  and  variables  before  the 
block  can  be  solved: 
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blk_nbr_max_eqnerr       Array  of  maximum  errors  for  the  block  equations 
bik_xibr_max_varcor       Array  of  maximum  variable  corrections  for  the  block 

variables 

blk_nbr_imax_eqnerr      Array     of     multipliers     to     blk_/ibx_max_eqnerr     for 

alpha  <  1 

blk_nbr_imax_varcor      Array     of     multipliers     to     blk_nbr_max_varcor     for 

alpha  <  1 

bik_nbr_cnt  Number  of  iterations  (initialized  to  0) 

blk_nbr_cnt_div  Number  of  diverging  iterations  (initialized  to  0) 

blk_nbr_alpha  Block  continuation  parameter. 

=  1  if  linear  block 
=  sb_alpha_init  if  nonlinear  block 

blk_nbx_daipha  Block  continuation  parameter  increment 

=  sb_dalpha_init 

good_aipha  Last  value  of  alpha  for  which  block  converged. 

Initialized  to  - 1 

good_var_nd_zibr  Last  value   of  node   nbr  potential   for  which  block 

converged.  Initialized  to  var_nd_abr 

good_var_fv_najne  Last    value    of   import    flow    name    for    which    block 

converged.  Initialized  to  var_f  v_name 

bik_nbr_trec  Recommended  recalculation  time  for  block 

Initialized  to  ttl 

bik_nbr_ivc  Array  of  indexes  in  block  variable  array  for  which  the 

variable     correction     was     greater     than     allowed. 
Initialized  to  an  empty  array. 

div_cnt  Number  of  diverging  iterations,  set  to  0 

div_err  Maximum  relative  error  of  previous  iteration 

Initially  set  to  0. 


-85- 


3.4.3.2.2.2  Continuation  Parameter  Loop 

The  block  continuation  parameter  loop  continues  as  long  as  blk_n±»r_aipha  <  l. 
Within  this  loop,  the  following  procedures  occur: 

1.  Import  Variables  for  all  associated  devices  specified 

2.  Device  Objects  called  to  generate 

A.  Export  Variables 

B.  Device  Jacobian  Matrix 

C.  State  values  at  time  tti 

D.  Recommended  recalculation  time 

3.  Block  recalculation  time  calculated 

4.  KCL  and  Potential  Difference  Equation  Errors  calculated 

5.  Errors  Scaled  and  compared  to  maximum  limits 

if  good,  solution  saved  and  bik_nbr_aipha  incremented 
as  necessary. 

6.  Iterations  counted  and  compared  to  maximum  limit 

bik_ni>r_alpha  decremented  and  variables  reset 
as  necessary. 

7.  Block  Jacobian  Matrix  assembled  and  scaled 

8.  Variable  Corrections  Calculated 

9.  System  variables  corrected 

3.4.3.2.2.2.1  Device  Import  Variable  specification 

The  matrix  dev_i_name  is  generated  for  each  device  name  where  the  columns 
are  the  waveform  coefficients  for  each  of  the  device  import  variables.  Each  column  of 
the  dev_i_name  matrix  is  one  of  the  system  variables,  hence  all  are  available. 

3.4.3.2.2.2.2  Call  Device  Objects 

Each  of  the  device  objects  associated  with  the  block  is  provided  with  the 
following  information: 

wtype  Waveform  type 

dev  i  name  Device  name  import  variable  matrix 


86- 


dev_par_name      Device  name  parameter  array 

dev_sO_name        Device  name  state  initial  value  tto  array 

tt  Time  structure 

blk_n±>r_alpha    Block  nbr  Continuation  Parameter 

From  this  information,  each  of  the  device  objects  generates  the  following 

dev_e_name  Device  name  export  variable  matrix 

dev_j_name  Device  name  jacobian  matrix 

dev_sl_name        Device  name  state  final  value  ttl  array 

dev_tr_name        Device  name  recommended  recalculation  structure 

=  [ntl  ntt]  where 
ntl  =  recommended  ttl  for  present  interval 

or  set  to  ttl  if  no  recommendation 
ntt  =  recommended  ttl  for  next  interval 

or  set  to  tto  if  no  recommendation 

3.4.3.2.2.2.3  Recommended  Recalculation  Time 

The  block  recommended  recalculation  time  bik_nbr_trec  is  set  to  the 
minimum  value  of  all  the  ntl  values  from  all  of  the  devices  associated  with  the  block. 
If  convergence  fails  bik_nbr_trec  is  used  to  generate  a  new  value  for  ttl. 

Similarly,  blk_n£>r_ntrec  is  set  to  the  minimum  value  of  all  the  ntt  values 
greater  than  ttl  from  all  of  the  devices  associated  with  the  block.  For  a  successful 
convergence,  bik_nbr_ntrec  is  used  to  help  generate  a  new  value  for  ttl  for  the 
next  waveform  interval. 

3.4.3.2.2.2.4  Equation  Errors 

For  each  of  the  node  nd  KCL  equations  associated  with  block  nbr,  an  error 
variable  bik_nbr_kcl_nd  is  generated  by  adding  the  flow  variables  of  the  attached 
terminals  to  the  flow  through  Gmin.  Likewise,  for  each  of  the  export  potential  name 
Potential  Difference  equations  associated  with  block  nbr,  an  error  variable 
blk_ni>r_pot_name  is  generated  by  subtracting  from  the  node  potential  waveform,  the 
waveform  of  the  export  potential  as  well  as  the  contribution  from  Rmin 

blk  nbr   kcl  nd   =  X  dev_e_name ( : , col)    +  I  var_fv_vname  + 

var  nd  nd   x  Gmin 
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blk_nb.r-_pot_vname  =  var_nd  nd   -    dev  e  name  (:,  col)     - 
dev  x  name (:, col)    x  Rmin 


where 


nbr  Block  Number 

nd  Node  Serial  Number 

name  Device  name 


vname 


Variable  name 


( : ,  col)        The  appropriate  column  from  the  matrix 
x  Either  e  or  i  depending  on  associated  flow  variable 

being  an  export  or  import  variable 

The  KCL  equation  errors  are  multiplied  by  the  appropriate  flow  variable  scaling  factor 
from  the  sys_flow_scale  array  while  the  Potential  Difference  equation  errors  are 
multiplied  by  the  appropriate  potential  scaling  factor  from  the  sys_pot_scaie  array. 
Once  scaled,  the  error  vectors  are  assembled  into  a  block  error  vector  bik_n±>r_err. 

3.4.3.2.2.2.5  Error  Criteria  Check 

Applying  Error  Criteria 

If  blJc_nbr_alpha  >  l  then  blk_n±>.r_ier  is  filled  with  the  indexes  of  the  rows 
of  bik_nbr_err  which  are  greater  in  magnitude  than  the  corresponding  rows  of 
b l k_nbr_ma x_e qnerr.  In  the  same  manner,  blk_ni>r_rel_err  is  set  equal  to  the 
absolute  value  of  blk_n±»r_err  divided  by  blk_nbr_max_eqnerr. 

If  bik_n±>r_alpha  <  l  then  blk_nbr_ier  is  filled  with  the  indexes  of  the  rows 
of  bik_nbr_err  which  are  greater  in  magnitude  than  the  corresponding  rows  of 

blk_n±>r_imax_eqnerr.  Similarly,  blk_nbr_rel_err  is  Set  equal  to  the  absolute 
value  of  blk_ni>r_err  divided  by  blk_n£>r_imax_eqnerr. 

Divergence  Check 

On  the  first  iteration  for  a  given  value  bik_n±>r_aipha,  div_cnt  is  initialized  to 
0.  For  the  first  sb_div_start_cnt  -  l  iterations,  div_err  is  set  to  the  maximum 
value  of  blk_nbr_rel_err.  On  subsequent  iterations,  if  the  maximum  value  of 
bik_nbr_rei_err  is  smaller  than  div_err  then  div_cnt  is  reset  to  0,  otherwise 
div_cnt  is  incremented.  In  any  case  div_err  is  set  to  the  maximum  value  of 
blk_nbr_rel_err.    If  div_cnt  >  sb_div_max_cnt  then  the  algorithm  assumes  the 
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block  is  diverging  for  the  given  value  of  blk_nbr_alpha.  The  failure  to  converge 
condition  is  indicated  by  setting  blk_nbr_cnt  =  maxcnt:  either  sb_i_maxcnt  if 
blk_n£>r_alpha   <    1  or  sb_maxcnt  ifblk_n£>r  alpha   >   1. 

Block  Convergence  Success 

If  blk_obr_ier  is  the  empty  set  or  sb_check_eqn_err  IS  0,  and 
blk_nbr_alpha  >  1  and  blk_nbr_ivc  is  the  empty  set,  then  the  block  solving 
algorithm  has  been  completed  and  the  continuation  parameter  loop  is  broken.  The 
algorithm  proceeds  to  checking  the  truncation  error  for  the  system  variables  associated 
with  the  block. 

Increment  Continuation  Parameter 

If  blk_n±>r_ier  is  the  empty  set  or  sb_check_eqn_err  is  0,  and 
blk_nbi_alpha  <  l  and  blk_nbr_ivc  is  the  empty  set,  then  it  is  time  to  increment 
the  continuation  parameter  bik_nbr_aipha.  First  however,  the  current  value  of  all 
the  variables  associated  with  the  block  are  copied  into  good_var_nd_nd  or 
good_var_fv_name.  blk_nbr_alpha  is  copied  into  good_alpha.  The  variables  and 
continuation  parameter  must  be  saved  because  it  may  be  necessary  to  restore  the 
variables  if  the  block  fails  to  converge  with  the  next  continuation  parameter  value. 
blk_nbr_alpha  is  then  set  equal  to  the  minimum  of  1  and 
blk_nbr_alpha  +  blk_nbr_daipha  and  the  continuation  parameter  loop  is  repeated. 

Iteration  Count:  Decrement  Continuation  Parameter 

If  the  error  is  still  too  large,  corrections  to  the  system  variables  associated  with 
the  block  must  be  generated.  But  first,  the  number  of  iterations  bik_nbr_cnt  must  be 
incremented  and  compared  to  the  maximum  allowed  maxcnt:  either  sb_i_maxcnt  if 

blk_nbr-_alpha   <    1   or   sb_maxcnt   if  blk_nbr_alpha   >   1.      If  the   limit   has  been 

exceeded,  and  one  of  the  devices  has  recommended  a  value  for  bik_n±>r-_trec  less 
than  ttl,  then  converge_faiiure  is  set  to  1  and  attempts  to  solve  the  block  cease.  If 
the  limit  has  been  exceeded  and  bik_nbr_trec  equals  ttl,  the  block  is  recalculated 
with  a  decremented  bik_n±>r_aipha  which  is  set  to  the  maximum  of: 

(blk   nbr_alpha    +   good_alpha)     /    2 

blk    nbx-_alpha    -    blk_nbr_dalpha 

0 
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If  blk_ni?r_alpha  has  been  decremented,  the  system  variables  associated  with 
the    block    must    be    reset    to    the    values    stored    in    either    good_var_nd_nd    or 

good  var    fv   name. 

Block  Convergence  Failure 

If  blk_ni>r_alpha    -    good_alpha   <    sb_dalpha_min  then  the  block  has  failed 

to  converge  and  nothing  more  can  be  done  on  the  block  level.  The  variable  tree  is 
Set  equal  to  blk_n±>r_trec  and  the  converge_failure  flag  is  set  to  1.  This  is  a 
signal  to  the  system  to  not  solve  any  more  blocks  and  either  adjust  the  value  of  tti  or 
adjust  the  number  of  coefficients  n  before  trying  to  solve  the  system  again. 

3.4.3.2.2.2.6  Assemble  Jacobian 

Jacobian  Construction 

If  the  error  is  too  large,  but  the  maximum  number  of  iterations  maxent  has  not 
been  exceeded,  the  block  jacobian  matrix  must  be  calculated.  The  block  jacobian 
matrix  bik_nbr_j  is  constructed  in  the  same  manner  as  the  system  structural  jacobian 
was  previously  constructed  with  the  exception  that  now  the  variables  and  equations 
are  only  those  which  are  part  of  the  block  and  the  matrix  elements  are  submatrices 
instead  of  structural  jacobian  codes. 

Jacobian  Scaling 

Once  the  block  jacobian  has  been  assembled,  it  is  scaled  by  dividing  each  of  the 
columns  by  the  appropriate  element  of  either  the  sys_f  iow_scaie  (if  the  column 
corresponds  to  an  import  flow  variable)  or  sys_pot_scaie  (if  the  column  corresponds 
to  a  node  potential)  vectors.  Likewise,  rows  of  the  block  jacobian  are  multiplied  by 
the  appropriate  element  of  either  the  sys_f  iow_scaie  (if  the  row  corresponds  to  a 
KCL  equation)  or  sys_pot_scaie  (if  the  row  corresponds  to  a  Potential  Difference 
equation)  vectors.  Scaling  is  performed  to  normalize  all  of  the  variables  and 
hopefully  improve  the  accuracy  of  the  numerical  computations  required  for  solving 
the  variable  corrections. 

Correction  Vector  Calculation 

The  variable  correction  vector  bik_nbr_dita  is  generated  by  solving  the  matrix 
equation: 
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blJc_.nb.r_j    blk_nbr-_dlta   =   blk_nbr_err 

The  most  direct  method  (and  one  of  the  least  numerically  efficient  method)  of 
calculating  blk_nbr_dlta  is  to  invert  bik_nbr_j  and  multiply  by  bl)c_nbr_err. 
Relaxation  methods  and  Gaussian  elimination  with  back  substitution  are  other  means 
to  the  same  end. 

Singular  Jacobian 

If  blk_nbr_j  is  singular,  blk_nbr_dlta  can  not  be  calculated  and  in  the  present 
incarnation  of  WAVESEM,  the  simulation  fails.  Future  versions  should  include  an 
algorithm  for  attempting  to  recover  from  the  singular  jacobian. 

3.4.3.2.2.2.7  Correct  Variables 

Each  of  the  system  variables  associated  with  the  block  are  corrected  by 
subtracting  the  appropriate  rows  of  blk_nbr_dlta  divided  by  the  corresponding 
element  of  the  scaling  factor  vectors  (sys_pot_scaie  or  sys_fiow_scaie). 

3.4.3.2.2.2.8  Variable  Correction  Criteria 

If  the  block  is  nonlinear  (blk_nbr_iinear_fiag  =  0)  and  the  variable 
correction  flag  is  set  (sb_check_var_err  =  l)  then  blk_nbr_ivc  contains  the 
indexes  of  blk_n±>x_dita  which  exceed  in  magnitude  bik_nbr_imax_varcor  if 
blk   nbr  alpha  <    1      or      b  1  k_nbr_ma x_va r c o r      if      blk_nbr_alpha   >   1.  If 

bik_nbr_ivc  is  not  empty,  then  one  of  the  variable  corrections  was  too  large  and 
another  iteration  is  necessary.  In  any  case,  the  continuation  parameter  loop  is 
repeated. 


-91  - 


3.4.3.2.2.3  Truncation  Error  Control 

Once  a  block  has  been  solved,  a  truncation  error  check  must  be  performed  on 
each  of  the  associated  system  variables.  The  truncation  error  is  assumed  negligible  if 
the  waveform  content  of  the  last  sb_nbr_wc  coefficients  of  each  waveform  is  less  than 
the  limit  specifed  by  sb_max_wc.  If  all  the  system  variables  have  negligible  truncation 
error,  block  nbr  has  been  solved  and  the  next  block  is  processed.  If  the  truncation  error 
of  any  of  the  variables  is  too  large,  converge_faiiure  is  set  to  1  to  indicate  the  block 
has  not  been  solved. 

3.4.3.2.3  Time  Step  Control:  Successful  Convergence 

If  all  the  blocks  successfully  obtained  a  solution  then  the  variable 
converge_faiiure  will  equal  0.  The  task  now  is  to  save  all  of  the  variables  in  the 
history  arrays,  update  ttO  and  tti,  update  n,  and  update  the  device  states. 

Update  History  Variables 

The  history  variables  are  extended  by  one  column.  The  variable  his_coi  is 
incremented  and  is  the  column  index  for  all  but  the  state  arrays.  In  particular: 

his_t (l,his_col)    =   ttO 
his_t (2,his_col)    =   ttl 

his_N(l,his_col)    =  N 

his_nd_n£>r  ( 1 :  N,  his_col)    =   var_nd_nbr 
his_f v_name  (1 :  N,  his_col)    =   var_fv_name 

his_s_name  ( :  ,his_col+l)    =   dev_sl_name 
dev    sO    name   =   dev    sl_name 

where  (l  :n,  his_coi)  refers  to  the  first  n  rows  of  column  his_coi  and  ( : ,  his_coi+i) 
refers  to  all  the  rows  of  column  his_coi  +  l. 

Update  Time  Interval  and  Number  of  Coefficients 

The  time  interval  is  updated  by: 

ttO  =  ttl 

If  ttO  >ti  then  the  simulation  has  successfully  completed  and  the  time  loop  is 
exited.  Otherwise  must  update  ttl  as  well.  Initially: 

ttl  =  ttl   +  ddt 
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Next,  check  if  a  break  point  (element  of  sb_bp)  exists  between  ttO  and  tti.  If 
such  a  break  point  exists,  set  tti  equal  to  the  earliest  break  point  after  ttO. 

Since  reducing  n  is  normally  beneficial,  if  tti  -  ttO  >  sb_dt_opti-mum  and 
n  >  sb_N_min  the  algorithm  assumes  the  waveforms  are  well  behaved  and 
decrementing  n  (as  long  as  n  >  sb_n_min)  is  appropriate. 

Since  the  series  converged  for  the  previous  time  increment,  setting  ddt  equal  to  the 
minimum  of  2xddt  and  sb_dt_max  allows  the  system  to  increase  the  next  time  interval 

Plot  Intermediate  Results 

Before  proceeding  to  solve  the  system  over  the  updated  time  interval,  WAVESEM 
creates  a  plot  of  the  system  variables  over  the  previous  time  interval. 
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3.4.3.2.4  Time  Step  Control:  Unsuccessful  Convergence 

Fatal  Error 

If  one  of  the  blocks  failed  to  converge,  tti  -  tt2  <  sb_dt_min,  and 
n  >  sb_n_max  then  the  simulation  has  failed  completely  and  can  not  proceed  further.  In 
this  case,  the  simulation  comes  to  a  halt  prematurely. 

Recommended  Recalculation  Time 

If  one  of  the  blocks  failed  to  converge  and  tree  <  tti,then  tti  =  tree  and  the 
time  loop  is  repeated. 

Time  Increment  /  Number  of  Coefficient  Control 

If  one  of  the  blocks  failed  to  converge  and  tree  >  tti, 
tti  -  ttO  <  sb_dt_optimum  and  n  <  sb_n_max,  n  is  incremented  in  an  attempt  to 
improve  convergence.  To  improve  convergence  if  tti  -  ttO  >  sb_dt_optimum  or 
n  >  sb_n_max,  the  time  interval  is  halved  by  setting  tti  =  (tti  +  tt0)/2.0. 
Halving  ddt  is  also  prudent  as  long  as  ddt  >  sb_dt_min.  Once  ddt  and  n  have  been 
updated,  the  time  loop  is  continued. 

3.4.3.3  Simulation  Wrap-up 

Once  the  simulation  has  completed,  the  variables  stored  in  the  history  arrays  are 
plotted  and  saved  as  the  user  desires.  If  the  operator  desires,  the  device  state  variables 
can  be  used  as  the  initial  conditions  for  a  following  simulation  or  saved  in  file  for  future 
simulations. 
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3.5  Device  Modelling  Techniques 

The  previous  sections  described  the  method  WAVESEM  uses  to  generate  a 
mathematical  system  of  equations  and  variables  for  interconnecting  a  number  of  different 
devices.  Up  to  now  a  device  has  been  treated  as  a  black  box  characterized  by  its  definition, 
initialization,  variables  which  must  be  provided  to  it  as  resources  and  variables  which  are 
generated  by  it  as  products.  As  a  review,  here  are  properties  of  the  black  box: 

Definition  (device,  def) 

Name  of  Device  Type 

Number  of  Parameters 
Names  of  Parameters 
Default  Values  of  Parameters 

Number  of  States 

Names  of  States 

Default  Values  of  State  Initial  Conditions 

Number  of  terminals 
Terminal  Definitions 

Terminal  Name 

Terminal  Type  (normal  or  information) 

Flow  Variable  Type  (import  or  export) 

Potential  Variable  Type  (import  or  export) 

Terminal  KCL  Group  Number 

Device  Structural  Jacobian 

Initialization  (WAVESIM  input  file) 

Name  of  Device 

Name  of  defining  Device  Type 

Parameter  Values 

State  Initial  Conditions 

Assignment  of  terminals  to  nodes 
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Resources  (Arguments  of  MATLAB  device. m  file) 

Waveform  type 

Import  Variable  Waveforms 

Parameter  Values 

Value  of  states  at  beginning  of  time  interval 

Time  Structure 

Beginning  time  of  Interval 

Ending  time  of  interval 

Minimum  time  interval  of  interest 
Continuation  Parameter 

Products  (Products  of  MATLAB  device. m  file) 

Export  Variable  Waveforms 
Device  Jacobian  Matrix 
Value  of  states  at  end  of  time  interval 
Recommended  Time  Structure 

Recommended  Recalculation  Time  this  interval 

Recommended  ending  time  of  next  interval. 

While  these  specifications  are  the  hard  requirements  for  developing  a  new  device  type, 
they  are  not  very  constraining  and  it  is  possible  to  generate  very  inefficient  and  unworkable 
devices.  The  following  sections  are  meant  as  guidance  for  developing  new  device  types. 
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3.5.1  Import  and  Export  Variable  definitions 

One  of  the  first  tasks  in  designing  a  new  object  is  determining  which  variables  should 
be  import  variables  and  which  should  be  export  variables.  The  requirement  is  simply  that 
the  total  number  of  export  variables  associated  with  normal  terminals  must  equal  the  total 
number  of  import  variables  associated  with  normal  terminals.  To  minimize  the  number  of 
system  equations  however,  one  should  usually  try  to  define  flow  variables  as  export 
variables  and  potential  variables  as  import  variables. 

The  constitutive  equations  defining  a  device  may  preclude  defining  all  the  flow 
variables  as  export  variables.  An  ideal  voltage  source  of  magnitude  Vs  for  example,  has 
the  following  constitutive  equations: 

Clearly,  this  set  of  equations  can  not  be  reorganized  to  specify  both  currents  (flows) 
explicitly.  In  this  case  potential  Vt  and  flow  Ij  are  export  variables  and  potential  V2  and 
flow  I2  are  import  variables. 
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3.5.2  Interface  Variable  Units 

When  developing  devices,  a  consistent  convention  for  interface  variable  units  is 
required.  Flows  are  usually  referenced  such  that  positive  flow  into  a  terminal  with  a 
positive  potential  refers  to  power  dissipated  by  the  device.  This  definition  is  clear  if  the 
flow  corresponds  to  currents  or  forces,  but  is  less  clear  for  torques.  For  rotating  shafts 
where  torques  are  the  flow  variable  and  rotational  speed  the  potential,  the  positive 
direction  for  speed  is  in  the  normal  operating  direction  while  the  direction  for  torque  is 
determined  by  the  power  dissipation  rule.  A  motor  connected  to  a  propeller  would 
normally  have  associated  a  positive  rotational  speed  and  a  negative  torque.  The  propeller 
would  have  a  positive  rotational  speed  and  a  positive  torque  associated  with  its  interaction 
with  the  motor  along  with  a  positive  forward  speed  and  negative  force  associated  with  its 
interaction  with  the  ship  dynamics.  The  ship  dynamics  model  would  have  an  associated 
positive  force  and  positive  forward  speed. 

Many  power  system  simulations  go  through  great  effort  to  normalize  all  variables  by 
dividing  by  device  base  quantities  to  improve  numerical  accuracy.  The  models  are  all 
expressed  in  a  Per  Unit  (PU)  basis  where  the  base  quantities  are  machine  ratings.  The 
problems  occur  when  several  devices  with  different  base  quantities  are  combined.  The 
system  variables  must  all  be  scaled  appropriately  to  ensure  the  elements  of  the  system 
equations  are  all  in  the  same  units.  Keeping  the  bases  consistent  requires  much  effort  and 
is  very  prone  to  error. 

In  WAVESIM,  physical  quantities  using  the  metric  system  (SI)  are  recommended  for 
all  interface  variables.  Strict  use  of  the  metric  system  ensures  the  proper  quantities  are 
added  and  subtracted  on  the  systems  level.  Individual  devices  may  then  scale  the  interface 
variables  by  their  own  base  quantites  for  internal  calculations.  Likewise,  each  node  of  the 
system  can  have  a  scaling  factor  assigned  to  it  for  both  flow  and  potential  variables.  In  this 
manner,  the  beneficial  aspects  of  the  per  unit  system  can  be  retained  with  little  confusion 
as  to  ensuring  consistent  base  quantities. 
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Metric  System  (SI) 


Length 

meters 

Time 

seconds 

Mass 

kilograms 

Voltage 

volts 

Current 

amperes 

Force 

newtons 

Angle 

radians 

Speed 

meters/second 

Rotational  Speed 

radians/second 

Torque 

newton-meters 
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3.5.3  Potential  References 

The  node  potentials  are  all  referenced  to  an  arbitrary  value  called  0.  The  reference 
frame  for  this  level  is  a  property  of  the  device  definition,  but  must  be  consistent  with  the 
reference  frame  for  other  device  definitions  to  which  the  device  may  be  connected. 
Following  are  suggested  reference  points: 

Electrical  Voltage  Volts  above  Ground  Potential 

Mechanical  Angle  Radians  relative  to  the  positive  vertical 

Mechanical  Rotational  Radians  per  Second  relative  to  stationary 
Speed 

Mechanical  System  Dependent 

Displacement 

Mechanical  Speed  meters  per  second  relative  to  stationary 

If  mechanical  rotational  speeds  or  mechanical  speeds  are  specified,  but  the  actual  angle  is 
required  within  the  device  calculations,  the  speed  can  be  integrated.  If  more  than  one 
device  requires  the  integration  of  the  speed,  then  the  system  modeller  must  ensure  the  state 
initial  conditions  corresponding  to  the  angle  or  displacement  is  consistent  for  all  devices. 

If  an  absolute  reference  cannot  be  established  for  a  device,  two  terminals  can  be 
defined  such  that  all  constitutive  relations  depend  only  on  the  difference  between  the  two 
terminal  potentials.  This  relative  definition  of  potentials  is  commonly  used  for  modelling 
circuit  elements.  An  ideal  transformer  for  example,  is  a  four  terminal  device  with  the 
following  constitutive  equations: 

*lp  =  "  *lm 

hp  =  '  '2m 

Note  that  Vip  is  defined  relative  to  Vlm  and  is  a  function  of  (V2p  -  V2m).  None  of  the  export 
flow  variables  is  a  function  of  the  absolute  value  of  any  of  the  potentials. 
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3.5.4  Discontinuity  Control 

One  of  the  difficulties  with  using  vectors  of  orthogonal  series  coefficients  to 
represent  waveforms  is  the  poor  truncation  error  performance  when  approximating 
discontinuous  variables  or  variables  having  discontinuous  derivatives.  These 
discontinuities  are  usually  a  function  of  either  time  or  the  zero  crossing  of  one  of  the 
variables.  In  any  case,  the  time  of  the  discontinuity  is  often  easily  determined  by  the 
device  object.  If  the  frequency  of  the  discontinuities  is  low  enough,  it  would  be  prudent 
for  the  device  to  specify  the  earliest  discontinuity  of  the  interval  as  a  recommended 
recalculation  time. 

If  the  discontinuity  is  a  function  of  a  waveform  zero  crossing,  special  care  must  be 
taken  to  ensure  the  device  does  not  continously  estimate  the  zero  crossing  to  be  within  a 
small  increment  of  ttO  or  tti  and  force  the  time  loop  to  iterate  tti  around  the 
discontinuity.  One  way  around  this  problem  is  for  the  device  to  move  or  remove  any 
discontinuities  within  sb_dt_ave  of  either  ttO  or  tti  in  any  of  its  export  variables.  If 
sb_dt_ave  is  small  enough,  then  moving  the  discontinuity  should  not  affect  the  accuracy 
of  the  simulation  very  much  yet  still  prevent  the  system  time  loop  from  hunting  for  the 
discontinuity  by  varying  tti. 

If  many  discontinuities  occur  in  an  export  variable  more  frequently  than  sb_dt_ave, 
then  the  export  variable  should  be  smoothed.  The  smoothing  operation  calculates  the  local 
average  of  a  waveform  over  the  interval  [t-sb_dt_ave,t+sb_dt_ave].  In  this  manner,  the 
higher  order  terms  of  the  export  variable  are  attenuated  and  the  waveform  is  more  likely  to 
pass  the  truncation  error  test. 
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3.5.5  Consistent  Initial  Conditions 

Most  simulation  environments  require  the  user  to  specify  the  initial  values  for  all  the 
states  at  time  to.  In  this  regard  WAVESIM  is  no  different.  Unfortunately,  determining  a 
consistent  set  of  initial  conditions  which  meet  some  definition  of  normal  operating 
conditions  is  not  an  easy  task  for  either  a  system  modeler  or  a  computer  program.  First  of 
all,  the  concept  of  a  normal  operating  condition,  is  not  always  easy  to  describe 
mathematically.  Furthermore,  even  if  a  definition  for  normal  operating  condition,  can  be 
made,  there  is  often  much  difficulty  in  determing  that  condition. 

An  ideal  solution  would  be  for  each  device  to  calculate  its  own  initial  conditions 
during  the  first  time  increment.  If  a  device  is  capable  of  determining  an  initial  condition 
based  only  on  its  parameters  and  the  values  of  its  import  variables,  then  the  following 
technique  can  be  used: 

1.  Define  a  state  called  ic,  always  initialize  it  to  0. 

2.  Define  Sufficient  Parameters  to  determine  the  normal  operating  condition. 

3.  Within  the  constitutive  equations,  have  a  check  for  the  initial  value  of  ic 
equalling  zero.  If  ic  =  0  at  the  beginning  of  the  interval  then  use  the 
equations  for  the  normal  operationg  condition  to  determine  the  initial  values  of 
the  other  states.  Otherwise  use  the  initial  values  of  the  other  states  as  passed  to 
the  device.  In  any  case,  the  final  value  for  the  state  ic  should  be  set  to  1. 

This  method  for  determining  the  initial  conditions  is  well  suited  for  determining  the 
initial  conditions  of  the  states  of  rotating  machines.  Essentially,  a  load  flow  is  conducted 
in  the  first  time  increment  to  determine  the  initial  state  values. 
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3.5.6  Waveform  type  conversion 

Performing  the  calculations  for  the  constitutive  equations  for  certain  devices  may  be 
easier  to  accomplish  in  one  waveform  over  other  waveforms.  Converting  the  import 
variables  to  a  fixed  waveform  type  is  permissible  and  at  times  desirable.  As  long  as  the 
export  variables  are  converted  back  to  the  proper  type  and  the  jacobians  reflect  the 
waveform  conversions,  all  should  work  out  well. 

If  the  export  variables  depend  on  higher  order  terms  of  intermediate  calculations, 
converting  the  import  variables  to  waveforms  of  a  length  longer  than  n  and  performing  all 
of  the  intermediate  calculations  using  this  longer  length  before  truncating  back  to  n  when 
generating  the  export  variables  may  be  desirable  in  avoiding  excessive  truncation  errors. 
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Chapter  4  WAVESIM 

4.1  Basic  Description 

WAVESIM,  a  simulation  program  written  in  the  C  programming  language, 
demonstrates  the  algorithms  discussed  in  detail  in  Chapter  3  for  simulating  systems  of 
nonlinear  lumped  parameter  models  representing  the  electro-mechanical  components 
comprising  an  Integrated  Electric  Drive  system.  The  general  characteristics  of  WAVESIM 
are: 

1.  System  and  Simulation  Parameters  specified  in  a  text  Input  File. 

2.  Device  Definitions  are  in  text  file  device  .  def . 

3.  WAVESIM  Performs  following  4  tasks: 

A.  Reads  in  Device  Definitions  and  initializes  simulation. 

B.  Reads  Input  File  and  determines  devices  and  nodes  of  system. 

C.  Builds  and  reduces  system  into  a  sequence  of  blocks. 

D.  Writes  a  MATLAB  script  file  for  conducting  the  simulation. 

4.  The  actual  Simulation  is  conducted  in  MATLAB. 

5.  Supported  Waveform  types  are: 

A.  Data  Series. 

B.  Fourier  Series. 

C.  Legendre  Series. 

D.  Polynomial  Expansions. 

E.  Chebyshev  Series. 

6.  Waveform  operators  are  MATLAB  functions  defined  in  M-files. 

7.  Device  Constitutive  Equations  are  detailed  in  MATLAB  functions  defined  in 
M-files. 

8.  The  present  Incarnation  of  WAVESIM  has  these  limitations: 

A.  Subsystems  have  not  been  implemented. 

B.  System  and  Device  Structural  Jacobians  must  be  time  independent. 

C.  Newton-Raphson  is  the  only  equation  solving  method  used. 
Relaxation  Techniques  have  not  been  implemented. 
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MATLAB  was  chosen  as  the  environment  for  conducting  the  simulation  for  the 
following  reasons: 

1.  MATLAB  is  ideally  suited  for  treating  vectors  and  matrices  as  abstract  data 
types. 

2.  MATLAB  has  built  in  plotting  routines. 

3.  The  ability  to  create  MATLAB  M-files  which  when  invoked,  execute  a  long 
series  of  commands  called  a  script.  M-files  can  also  be  used  to  create  new 
MATLAB  functions. 

4.  MATLAB  has  many  built  in  functions  for  analysing  matrix  properties. 

5.  Since  WAVESIM  is  an  algorithm  demonstration  program,  speed  is  not  of 
primary  concern.  Interest  in  determining  if  the  algorithms  work  is  of  higher 
interest  than  optimizing  for  speed. 
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4.2  Running  WAVESIM 

Under  either  the  UNIX  operating  system  or  IBM  DOS,  WAVESIM  is  executed  by 
entering  at  the  commmand  prompt: 

athena%  wavesim  file. in 

where  file .  in  is  an  optional  entry  for  the  file  name  of  the  input  file.  WAVESEM 
will  attempt  to  read  in  the  device  .def  file  and  if  successful,  will  display  the  following 
header: 

WAVESIM 

Revision  2.0      <>      April  1991 

(C)  Copyright  1990,1991  by  Norbert  H.  Doerry 

If  WAVESIM  encountered  errors  when  reading  device. def,  an  error  message  is 
printed  and  the  program  terminates. 

If  file,  in  was  not  specified  on  the  command  line,  the  user  is  prompted  for  a  file 
name: 

Enter  WAVESIM  INPUT  file  name  : 

If  instead  of  a  file  name  q  is  entered,  WAVESIM  terminates  execution.  A  directory 
listing  can  be  obtained  by  entering  a  ?  followed  optionally  by  a  file  specification  (operating 
system  dependent). 

Under  normal  execution  of  WAVESIM,  there  is  no  further  interaction  with  the  user. 
WAVESIM  automatically  creates  an  output  file  having  the  same  base  filename  as 
file  .  in  but  having  .m  as  an  extension  (i.e.  file  .  in  becomes  file  .  m). 

NOTE:  Do  not  create  input  files  with  .  m  extensions  as  these  files  will  be  overwritten 
by  WAVESIM.  Also  avoid  using  file  names  which  are  valid  MATLAB  functions. 

WAVESIM  provides  extensive  support  for  providing  the  user  with  feedback  through 
the  use  of  the  DEBUG  command.  Most  of  the  major  routines  in  WAVESIM  have  a  debug 
option  for  displaying  the  results  of  calculations  internal  to  WAVESIM. 
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If  errors  are  found  reading  either  device  .  def  or  the  input  file,  WAVESIM  displays 
an  error  message  which  includes  the  file  name  and  the  line  number  within  the  file. 
WAVESIM  attempts  to  continue  reading  an  input  file  even  if  errors  are  detected  but  will 
only  create  an  output  file  if  no  errors  are  encountered. 
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4.3  Input  File  Specification 

The  Input  File  describes  the  system  topology,  defines  the  device  parameters,  and 
specifies  simulation  paramaters.  The  basic  characteristics  of  the  file  are: 

1.  ASC  H  text  files. 

2.  Lines  beginning  with  %,  #  or  !  are  ignored.  Empty  lines  are  ignored  as  well. 

3.  Data  lines  can  be  continued  on  the  following  line  if  the  last  characters  in  the  line 
are  ...  or  \. 

4.  Commands  all  begin  with  a  key-word.  Key-words  are  case  insensitive  and 
usually  can  be  truncated  to  three  letters  unless  a  conflict  with  another  key-word 
exists. 

5.  Commands  and  their  arguments  may  be  separated  by  either  spaces  or  tabs. 

6.  The  contents  of  other  files  can  be  incorporated  by  using  the  INCLUDE  command. 

7.  Single  Line  Commands  have  data  arguments  entered  on  only  one  line. 

8.  Multiple  Line  Commands  consist  of  groups  of  subordinate  commands.  The  group 
must  end  with  a  line  beginning  with  the  key-word  END. 

Here  is  a  summary  of  the  Commands  available  : 


DEBUG 

DEFAULT 

DEVICE 

INCLUDE 

NODE 

TIME 


Print  Debug  Information 

Default  System  Parameter  Initialization 

Device  Specification 

Include  another  file 

Node  Parameter  Specification 

Time  Increment  Control 
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Example  Input  File 


% 

%  rcrc.in 

% 

debug 

build_system_identify 

build_system_blocks 

f ind_block 

END 
% 
device  VDC_SOURCE  Vs 

TERMINAL   1  1 

TERMINAL   2  0 

PARAMETER    VS  1 . 0 

END 
% 


0.1 


device  RESISTOR 

Rl 

TERMINAL   1 

1 

TERMINAL   2 

2 

PARAMETER 

R 

END 

% 

device  RESISTOR 

R2 

TERMINAL   1 

2 

TERMINAL   2 

3 

PARAMETER 

R 

END 

% 

device  INDUCTOR 

LI 

TERMINAL   1 

2 

TERMINAL   2 

0 

PARAMETER 

L 

END 

% 

device  INDUCTOR 

L2 

TERMINAL   1 

3 

TERMINAL   2 

0 

PARAMTER 

L 

END 

% 

device  CAPACITOR 

CI 

TERMINAL   1 

2 

TERMINAL   2 

0 

PARAMETER 

C 

END 

% 

device  CAPACITOR 

C2 

TERMINAL   1 

3 

TERMINAL   2 

0 

PARAMETER 

C 

END 

% 

1.0 


1.0 


1.0 


1.0 


1.0 


n 

II 


nj 


© 


UUUJ 


Q 


n 
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Example  Input  File  (continued) 


% 

node  1 

scale 

potent 

ial  1 

.0 

scale 

flow 

1 

.0 

error 

kcl 

5e- 

-3 

error 

pot 

5e- 

-3 

end 

% 

default 

Gmin 

0 

Rutin 

0 

check  both 

error  eqn  kcl  5e-3 

error  eqn  pot  5e-3 

error  var  node  5e-3 

error  var  flow  5e-3 

error  mult  kcl  10.0 

error  mult  pot  10.0 

error  mult  node  10.0 

error  mult  flow  10.0 

scale  potential  1.0 
scale  flow      1 . 0 

max  count  10 
max  int  count  6 

alpha  init  1 . 0 
alpha  inc  init  .25 
alpha  inc  min  . 05 

diverge  start  3 
diverge  max  cnt  2 
diverge  error  mult  10.0 

waveform  content  max  .005 
waveform  content  nbr  2 

wtype  3 

nbr  coef  7 
nbr  coef  min  6 
nbr  coef  max  14 
nbr  data  20 


END 

% 

time 

dt  min 

0 

.025 

dt  max 

5 

.0 

dt  opt 

0. 

.250 

dt  init 

1, 

.0 

dt  ave 

0 

.0 

start 

0. 

.0 

finish 

20, 

.0 

END 
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4.3.1  DEBUG 

If  DEBUG  is  specified  without  any  arguments,  the  command  is  interpreted  as  a 
multi-line  command.  Each  of  the  following  lines  should  contain  the  name  of  one  of  the 
subroutines  listed  below.  If  the  key-word  OFF  follows  the  subroutine  name,  the  debug  flag 
for  that  subroutine  is  turned  off.  Otherwise,  the  debug  flag  for  the  specified  routine  is 
turned  on.  The  last  line  of  the  group  should  begin  with  the  key-word  END. 

If  DEBUG  is  specified  with  arguments,  the  command  is  interpreted  as  a  single-line 
command  and  the  arguments  should  consist  of  one  of  the  subroutines  listed  below  and 
optionally,  the  key-word  OFF.  A  single  line  command  does  not  have  an  END  keyword 
associated  with  it. 

Here  is  a  list  of  subroutines  for  which  debug  flags  have  been  defined  (Note:  The 
subroutine  names  are  case  sensitive) 

init_devices 

read_device_def 

read_file 

read_f  ile_device 

read_file_default 

r e  ad_f  i 1 ejnode 

r  e  ad_f  i  1  e_t  ime 

re  ad_f  i 1  e_debug 

build_system 

build_system_identify 

build_system_structural_jacobian 

build   system_bloc)cs 

find_block 

print_system__identify 

write    file 
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4.3.2  DEFAULT 

If  DEFAULT  is  specified  without  any  arguments,  the  command  is  interpreted  as  a 
multi-line  command.  Each  of  the  following  lines  should  contain  one  of  the  subordinate 
commands  listed  below.  The  last  line  of  the  group  should  begin  with  the  key-word  END. 

If  DEFAULT  is  specified  with  arguments,  the  command  is  interpreted  as  a  single-line 
command  and  the  arguments  should  consist  of  one  of  the  subordinate  commands  listed 
below.  A  single  line  command  does  not  have  an  END  keyword  associated  with  it. 

Here  is  a  summary  of  the  DEFAULT  subordinate  commands: 


ALPHA 

CHECK 

DIVERGE 

ERROR 

GMIN 

MAX 

NBR 

RMIN 

SCALE 

WAVEFORM  CONTENT 

WTYPE 


Continuation  Parameter  Control 
Error  Checking  Flags 
Divergence  Test  Control 
Default  Error  Levels 
Default  Node  Leakage  Conductance 
Maximum  Iteration  Counts 
Number  of  Coefficients  Control 
Default  Node  Series  Resistances 
Default  Variable  Scaling  Factors 
Waveform  Content  Limits 
Waveform  Type 
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4.3.2.1  DEFAULT :  ALPHA 

The  ALPHA  subordinate  command  specifies  the  parameters  needed  to  control  the 
continuation  parameter  for  nonlinear  blocks. 


Command 

ALPHA  INIT  Value 

ALPHA  INC  INIT  Value 
ALPHA  INC  MIN  Value 


Description 

Continuation 
Initial  Value 

Continuation 
Initial  Increment 


MATLAB  Variable 

Parameter  sb_aipha_init 

Parameter  sb  daipha  init 


Minimum  Continuation  sb_dalpha_min 

Parameter  Increment 


For  a  nonlinear  block,  the  continuation  parameter  is  initialized  to  the  ALPHA  INIT 
value.  The  initial  increment  for  the  continuation  parameter  is  specified  by  ALPHA  INC 
INIT.  If  the  block  fails  to  converge,  the  continuation  parameter  is  progressively 
decremented  until  the  block  converges  or  if  convergence  fails  due  to  the  difference 
between  the  last  value  of  the  continuation  parameter  that  converged  and  the  present  value 
of  the  continuation  parameter  being  less  than  ALPHA  INC  MIN.  If  the  block  converges, 
the  continuation  parameter  is  incremented  by  ALPHA   INC   INIT  until  it  equals  1. 

4.3.2.2  DEFAULT :  CHECK 

The  CHECK  subordinate  command  determines  for  nonlinear  blocks,  whether  the 
equation  error,  the  variable  correction  magnitude,  or  both  should  be  used  for  the 
convergence  criteria. 

Description  MATLAB  Variable 


Command 

CHECK  EQN 

CHECK  VAR 
CHECK  BOTH 


Check  only  Equation  Errors     sb_check_eqn_err  =  l 

sb_che  ck_var_e  r r   =    0 

Check  only  Variable    sb_check_eqn_err   =   0 

Corrections  sb_check_var_err   =    1 

Check  both  Equation  Errors  sb_check_eqn_err  =  l 
and  Variable  Corrections         sb  check  var  err  =  l 
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4.3.2.3  DEFAULT :  DIVERGE 

The  DIVERGE  subordinate  command  specifies  when  and  how  to  check  a  nonlinear 
block  for  divergence.  After  DIVERGE  START  iterations,  if  the  largest  relative  error 
increases  for  DIVERGE  MAX  CNT  iterations  and  the  relative  error  is  at  least  DIVERGE 
ERROR  MULT  then  the  block  is  assumed  to  be  diverging  and  the  converge_f  allure  flag 
is  set. 


Command 

DIVERGE  START  Value 

DIVERGE  MAX  CNT  Value 


DIVERGE  ERR  MULT  Value 


Description  MATLAB  Variable 

Number  of  iterations  to  wait  sb_div_start_cnt 
before  testing  for  divergence 

Number     of    iterations     to  sb_dlv_max_cnt 
allow      relative      error      to 
increase    befor    concluding 
divergence 

Value      of     relative     error  sb_i_div_err 
below     which     to     ignore 
divergence  iteration  count 
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4.3.2.4  DEFAULT :  ERROR 

The  ERROR  subordinate  command  determines  for  nonlinear  blocks,  the  default 
maximum  equation  errors  and  variable  corrections  which  are  permissible.  These  default 
values  can  be  overridden  for  a  specific  node  with  the  NODE  command.  When  the 
conituation  parameter  equals  1,  ERROR  EQN  KCL  is  the  maximum  error  for  the  node 
KCL  equtions  and  ERROR  EQN  POT  is  the  maximum  error  for  the  potential  difference 
equations.  Likewise  when  the  continuation  parameter  equals  1,  ERROR  VAR  NODE  is 
the  maximum  correction  to  a  node  potential  and  ERROR  VAR  FLOW  is  the  maximum 
correction  to  an  import  flow  variable.  The  ERROR  MULT  subordinate  commands  are 
multipliers  to  the  above  limits  for  continuation  parameters  less  than  1. 


Command 

ERROR  EQN  KCL  Value 

ERROR  EQN  POT  Value 
ERROR  VAR  NODE  Value 

ERROR  VAR  FLOW  Value 

ERROR  MULT  KCL  Value 

ERROR  MULT  POT  Value 

ERROR  MULT  NODE  Value 

ERROR  MULT  FLOW  Value 


Description  MATLAB  Variable 

Equation   sys_kcl_err1 


Default       KCL 
Maximum  Error 


Default  Potential  Difference  sys_var_err' 
Maximum  Error 


Default 

correction 

Potentials 


Maximum    sys_nd_err1 

to  Node 


Default  Maximum  sys_fv_err1 

correction   to   Import    Flow 

Variables 

Multiplier  to  ERROR      EQN  sb_i_kcl_err 
KCL      when      continuation 
parameter  <  1 

Multiplier  to  ERROR      EQN  sb_i_pot_err 
POT      when      continuation 
parameter  <  1 

Multiplier  to  ERROR     VAR  sb_i_nd_err 
NODE     when     continuation 
parameter  <  1 

Multiplier  to  ERROR      VAR  sb_i_fv_err 
FLOW     when     continuation 
parameter  <  1 

Note  1:  sys_xxx_err  are  actually  arrays  containing  for  each  equation  or  variable,  either 
the  deTault  value  specified  here  or  the  overriding  value  specified  in  the  NODE 
command. 
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4.3.2.5  DEFAULT :  GMIN 

The  GMIN  subordinate  command  defines  the  default  value  for  G^.  Gmin  is  used  to 
modify  the  KCL  equations  to  help  prevent  singular  systems.  Gni„  should  normally  be  set 
to  0  unless  a  singularity  problem  exists.  The  value  for  GmiM  can  be  overridden  for  a 
particular  node  through  the  NODE  command. 

Command  Description  MATLAB  Variable 

GMIN   Value  Leakage  Conductance  to  0  sys_Gmin1 

Potential 

Note  1:  sys_Gmin  is  actually  an  array  containing  the  value  for  Gmin  for  each  node:  either 
the  default  value  specified  here  or  the  overriding  value  specified  in  the  NODE 
command. 

4.3.2.6  DEFAULT :    MAX 

The  MAX  subordinate  command  determines  the  maximum  number  of 
Newton-Raphson  iterations  for  a  nonlinear  block  before  the  continuation  parameter  is 
decremented.  MAX  COUNT  specifies  the  maximum  number  of  iterations  when  the 
continuation  parameter  equals  1  while  MAX  INT  COUNT  specifies  the  maximum 
number  of  iterations  when  the  continuation  parameter  is  less  than  1. 


Command 

Description 

MATLAB  ^ 

MAX   COUNT    Value 

Maximum        number 

of  sb  maxcnt 

Iterations         when 

the 

continuation           parameter 

equals  1 

MAX    INT   COUNT    Value 

Maximum        number 

of  sb   i  maxcnt 

Iterations         when 

the 

continuation     parameter     is 
less  than  1 
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4.3.2.7  DEFAULT :    NBR 

The  NBR  subordinate  command  controls  the  number  of  coefficients  the  waveforms 
will  have.  NBR  COEF  specifies  the  initial  number  of  coefficients  to  use.  NBR  COEF 
MIN  is  the  minimum  number  of  coefficients  to  use  while  NBR  COEF  MAX  is  the 
maximum  number  of  coefficients.  NBR  DATA  is  the  number  of  data  points  per 
waveform  used  when  generating  plots. 


Command 

NBR  COEF  Value 

NBR  COEF  MIN  Value 
NBR  COEF  MAX  Value 
NBR  DATA  Value 


Description 

Initial  number 

coefficinets 


MATLAB  Variable 


Minimum 
coefficients 

Maximum 
coefficients 


number 


number 


of  n 


of  sb   n  min 


of  sb   n  max 


Number      of     points      per  sb_n_data 
waveform  to  use  in  plots.  ' 


4.3.2.8  DEFAULT :  RMIN 

The  RMIN  subordinate  command  defines  the  default  value  for  /?„„•„.  Rmin  is  used  to 
modify  the  Potential  Difference  equations  to  help  prevent  singular  systems.  R^  should 
normally  be  set  to  0  unless  a  singularity  problem  exists.  The  value  for  Rmi„  can  be 
overridden  for  a  particular  node  through  the  NODE  command. 

Command  Description  MATLAB  Variable 

RMIN   Value  Series  Resistance  for  Export  sys_Rmin1 

Potentials 

Note  1:  sys_Rmin  is  actually  an  array  containing  the  value  for  Rmin  for  each  node:  either 
the  default  value  specified  here  or  the  overriding  value  specified  in  the  NODE 
command. 
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4.3.2.9  DEFAULT :    SCALE 

The  SCALE  subordinate  command  specifies  the  default  scaling  parameters  for  the 
potential  and  flow  variables.  The  default  scaling  parameters  can  be  overridden  for  a 
particular  node  through  the  NODE  command. 


Command 

SCALE  POTENTIAL  Value 

SCALE  FLOW  Value 


Description 


MATLAB  Variable 


Default    scaling    factor    for  sysjpot^scale1 
Potentials 

Default    scaling    factor    for  sys_flow_scale1 
Flow  Variables 


Note  1:  sys_pot_scaie  and  sys_flow_scale  are  actually  arrays  containing  the  scaling 
factors  for  each  node:  either  the  default  values  specified  here  or  the  overriding 
values  specified  in  the  NODE  command. 

4.3.2.10  DEFAULT:  WAVEFORM  CONTENT 

The  WAVEFORM  CONTENT  subordinate  command  controls  the  maximum 
allowable  truncation  error  by  specifying  the  maximum  waveform  content  WAVE  CONT 
MAX  for  the  last  WAVE  CONT  NBR  coefficients  of  a  waveform. 


Command 

WAVE  CONT  MAX  Value 

WAVE  CONT  NBR  Value 


Description  MATLAB  Variable 

Waveform  sb  max  hh 


Maximum 
Content 


Number  of  Coefficients   to  sb_nbr_hh 
apply  maximum  to. 


4.3.2.11  DEFAULT:    WTYPE 

The  WTYPE  subordinate  command  specifies  the  waveform  type  to  use  in  the 
simulation 

Command 

WTYPE    Value 


Description 

Waveform  Type  Indicator 

1  Data  Series 

2  Fourier  Series 

3  Legencre  Series 

4  Polynomials 

5  MATLAB  Polynomials 

6  Chebyshev  Series 


MATLAB  Variable 


vrtype 
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4.3.3  DEVICE 

DEVICE  is  always  a  multi-line  command.    The  command  must  be  entered  in  the 
following  format: 

DEVICE   Device_Type   Name 

where: 

Device_Type  Device  Type  Name  from  device  .  def  file. 

Name  Name  of  this  particular  device. 
The  subordinate  commands  for  the  DEVICE  command  are: 

TERMINAL  Assign  Temiinals  to  Nodes  (mandatory). 

PARAMETER  Assign  Parameter  Values  (optional). 

STATE  Assign  State  Initial  Conditions  (optional). 

All  of  the  terminals  as  defined  in  the  device. def  must  be  assigned  to  a  node.  If  the 
parameters  or  states  are  not  assigned  values,  the  default  values  specified  in  device  .  def 
are  used. 

The  last  line  of  the  command  group  must  begin  with  the  key-word  END 

4.3.3.1  DEVICE :  TERMINAL 

The  TERMINAL  subordinate  command  assigns  a  terminal  to  a  node  and  must  be 
entered  in  the  following  format: 

TERMINAL    Term±nal_Name  Node_Nbr 

where: 

Terminal_Name        Terminal  Name  from  device .  def  file. 

Node_Nbr  Serial  Number  of  Node  this  terminal  is  attached  to. 

All  of  the  terminals  as  defined  in  device .  def  must  be  attached  to  a  node  of  the 
system. 
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4.3.3.2  DEVICE :    PARAMETER 

The  PARAMETER  subordinate  command  assigns  a  value  to  a  parameter  of  the 
device.  If  the  parameter  is  a  single  value  as  defined  in  device  .  def  then  the  parameter 
command  must  be  of  the  following  format: 

PARAMETER  Parameter_Name   Value 

where: 

Parameter_Name      Parameter  Name  from  device  .  def  file. 

Value  Parameter  Value. 

If  the  parameter  is  a  matrix  as  defined  in  device .  def  then  the  parameter 
command  must  be  of  the  following  format: 

PARAMETER  Parameter_Name  MATRIX 
matrix_values 
END 

where: 

Parameter_Name      Parameter  Name  from  device .  def  file. 

matrix_values         Parameter  matrix.   The  number  of  rows  and  columns 

of  the  matrix  must  be  the  same  as  specified  in  the 
device. def  file.  Rows  are  entered  one  line  at  a 
time  with  columns  separated  by  spaces. 

If  a  parameter  as  defined  in  device .  def  is  not  assigned  a  value,  then  the  default 
values  specified  in  device .  def  is  used. 
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4.3.3.3  DEVICE :  STATE 

The  STATE  subordinate  command  assigns  an  initial  value  to  a  state  of  the  device 
and  must  be  entered  in  the  following  format: 

STATE    State_Name    Value 

where: 

State_Name  State  Name  from  device  .  def  file. 

Value  Initial  value  of  state. 

If  a  state  as  defined  in  device .  def  is  not  assigned  a  value,  then  the  default 
values  specified  in  device  .  def  is  used. 
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4.3.4  INCLUDE 

INCLUDE  is  always  a  single-line  command.    The  command  must  be  entered  in  the 
following  format: 

INCLUDE   File_Name 

where: 

File_Name  Name  of  the  file  to  include. 

The  contents  of  the  included  file  are  inserted  at  the  location  of  the  INCLUDE 
command. 

4.3.5  NODE 

NODE  is  always  a  multi-line  command.     The  command  must  be  entered  in  the 
following  format: 

NODE    Node_Nbr 

where: 

Node_Nbr  Serial  Number  of  the  node. 

The  subordinate  commands  for  the  NODE  command  are: 

ERROR  Node  Error  Levels 

GMIN  Specify  node  G^,,  value 

NAME  Assign  a  name  to  the  node 

RMIN  Specify  node  Rmi„  value 

SCALE  Specify  node  scaling  factors 

The  last  line  of  the  command  group  must  begin  with  the  key-word  END 
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4.3.5.1  NODE:    ERROR 

The  ERROR  subordinate  command  determines  for  nonlinear  blocks,  the  maximum 
equation  errors  and  variable  corrections  which  are  permissible.  These  values  override  the 
default  values.  When  the  conituation  parameter  equals  1,  ERROR  EQN  KCL  is  the 
maximum  error  for  the  node  KCL  eqution  and  ERROR  EQN  POT  is  the  maximum  error 
for  the  potential  difference  equations.  Likewise  when  the  continuation  parameter  equals 
1,  ERROR  VAR  NODE  is  the  maximum  correction  the  node  potential  and  ERROR  VAR 
FLOW  is  the  maximum  correction  to  an  import  flow  variable.  The  ERROR  MULT 
subordinate  commands  of  the  DEFAULT  command  are  multipliers  to  the  above  limits  for 
continuation  parameters  less  than  1. 

Command  Description  MATLAB  Variable 

ERROR  EQN  KCL   Value  Maximum    KCL     Equation  sys_kcl_err1 

Error 

ERROR  EQN  POT    Value  Maximum  Potential  sys^a^err1 

Difference  Error 

ERROR  VAR  NODE    Value  Maximum      correction      to  sys_nd_err1 

Node  Potential 

ERROR  VAR  FLOW   Value  Maximum      correction      to  sys_fv_err1 

Import       Flow       Variables 
attached  to  this  node 

Note  1:  sys_xxx_err  are  actually  arrays  containing  for  each  equation  or  variable,  either 
the  default  value  or  the  overriding  value  specified  here. 

4.3.5.2  NODE:    GMIN 

The  GMIN  subordinate  command  defines  the  value  for  GTO„.  Gmi„  is  used  to  modify 
the  KCL  equation  to  help  prevent  singular  systems.  Gmi„  should  normally  be  set  to  0 
unless  a  singularity  problem  exists.  The  value  for  Gmin  overrides  the  default  value. 

Command  Description  MATLAB  Variable 

GMIN   Value  Leakage  Conductance  to  0  sys_Gmin1 

Potential 

Note  1:  sys_Gmin  is  actually  an  array  containing  the  value  for  Gmin  for  each  node:   either 
the  default  value  or  the  overriding  value  specified  here. 
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4.3.5.3  NODE:    NAME 

The  NAME  subordinate  command 

Command  Description  MATLAB  Variable 

NAME   Node_Name  Name  of  the  Node  sys^ode^ame1 

The  node  name  is  only  used  to  associate  the  node  serial  number  to  a  more 
understandable  label.  The  node  name  is  optional  and  does  not  affect  computation  in  any 
way. 

Note  1:  sys_node_name  is  actually  an  array  containing  the  names  of  all  the  nodes. 

4.3.5.4  NODE:    RMIN 


The  RMIN  subordinate  command  defines  the  node  value  for  /?„„„.  /?„„„  is  used  to 
modify  the  Potential  Difference  equations  to  help  prevent  singular  systems.  Rmin  should 
normally  be  set  to  0  unless  a  singularity  problem  exists.  The  value  for  Rmi„  overrides  the 
default  value. 

Command  Description  MATLAB  Variable 

RMIN   Value  Series  Resistance  for  Export  sys_Rmi.ii1 

Potentials 

Note  1:  sys_Rmin  is  actually  an  array  containing  the  value  for  Rmin  for  each  node:  either 
the  default  value  or  the  overriding  value  specified  here. 

4.3.5.5  NODE:    SCALE 

The  SCALE  subordinate  command  specifies  the  node  scaling  parameters  for  the 
potential  and  flow  variables.  The  scaling  parameters  override  the  default  values. 

Command  Description  MATLAB  Variable 

SCALE   POTENTIAL    Value        Scaling     factor     for     Node  sys_pot_scalel 

Potential 

SCALE   FLOW   Value  Node  scaling  factor  for  Flow  sys_flow_scale1 

Variables 

Note  1:  sys_pot_scaie  and  sys_fiow_scaie  are  actually  arrays  containing  the  scaling 
factors  for  each  node:  either  the  default  values  or  the  overriding  values  specified 
here. 
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4.3.6  TIME 

If  TIME  is  specified  without  any  arguments,  the  command  is  interpreted  as  a 
multi-line  command.  Each  of  the  following  lines  should  contain  one  of  the  subordinate 
commands  listed  below.  The  last  line  for  the  section  should  begin  with  the  key-word  END. 

If  TIME  is  specified  with  arguments,  the  arguments  should  consist  of  one  of  the 
subordinate  commands  listed  below.  A  single  line  command  does  not  have  an  END 
keyword  associated  with  it. 

The  subordinate  commands  for  the  TIME  command  are: 

BREAK  Insert  Break  Point 

DT  Time  Increment  Control 

FINISH  Ending  Time  of  Simulation 

START  Starting  Time  of  Simulation 

4.3.6.1  TIME:    BREAK 

The  BREAK  subordinate  command  inserts  a  simulation  break  point  which  forces  a 
waveform  boundary  to  occur  at  the  designated  time.  Bracketing  intervals  in  which  a 
discontinuity  will  occur  with  breakpoints  can  reduce  the  computational  effort  required  by 
WAVESIM. 

Command  Description  MATLAB  Variable 

BREAK    Time  Break  Point  time  sbjbp1 

sb_bp_nbr 

Note  1 :  sb_bp  is  actually  an  array  of  break  points  in  chronological  order.    sb_bp_nbr  is 
the  number  of  break  points. 
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4.3.6.2  TIME:    DT 


The  DT  subordinate  command  controls  the  waveform  interval. 


Command 

DT  MIN  Value 

DT  MAX  Value 

DT  OPTIMUM  Value 

DT  INITIAL  Value 
DT  AVE  Value 


Description 


MATLAB  Variable 


Minimum 
Increment 

Maximum 
Increment 

Optimum 
Increment 


Waveform  sb_dt_min 
Waveform  sb_dt_max 
Waveform  sb  dt  optimum 


Initial  Waveform  Increment    sb_dt_init 

Minimum  Time  Interval  of  sb_dt_ave 
Interest  (Averaging  Interval) 


If  the  time  interval  is  less  than  DT  OPTIMUM,  the  number  of  coefficients  is  less 
then  the  maximum  and  a  block  does  not  converge,  the  number  of  coefficients  is  increased 
for  the  next  iteration.  Otherwise,  if  the  block  does  not  converge  the  time  interval  is 
reduced. 

DT  AVE  is  the  minimum  time  interval  of  interest  and  is  used  by  devices  to  smooth 
their  export  waveforms  or  to  move  discontinuity  boundaries. 

4.3.6.3  TIME:    FINISH 

The  FINISH  subordinate  command  specifies  the  ending  time  of  the  simulation. 
Command  Description  MATLAB  Variable 

TIME  FINISH   Value  Ending  Time  of  Simulation     ti 

4.3.6.4  TIME :    START 

The  START  subordinate  command  specifies  the  beginning  time  of  the  simulation. 
Command  Description  MATLAB  Variable 

TIME   START    Value  Starting  Time  of  Simulation    to 
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4.4  Device  Definition  File  Specification 

The  device  definition  file  device. def  contains  the  definitions  of  the  device  types 
which  can  be  specified  in  a  WAVESIM  Input  File.  The  basic  characteristics  of  the  file  are: 

1.  ASC  H  text  files 

2.  Lines  beginning  with  %,  #  or  !  are  ignored.  Empty  lines  are  ignored  as  well. 

3.  Data  lines  can  be  continued  on  the  following  line  if  the  last  characters  in  the  line 
are  ...  or  \ . 

4.  Commands  all  begin  with  a  key-word.  Key-words  are  case  insensitive  and 
usually  can  be  truncated  to  three  letters  unless  a  conflict  with  another  key-word 
exists. 

5.  Commands  and  their  arguments  may  be  separated  by  either  spaces  or  tabs. 

6.  The  contents  of  other  files  can  be  incorporated  by  using  the  INCLUDE  command. 

7.  Single  Line  Commands  have  data  arguments  entered  on  only  one  line. 

8.  Multiple  Line  Commands  consist  of  groups  of  subordinate  commands.  The  group 
must  end  with  a  line  beginning  with  the  key- word  END. 
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Example  device .  def  File 


% 

%   device. def 

% 

%  debug  init_devices 

debug  read  device  def 

%         ~      ~ 

device  RESISTOR 

Terminal  1  Pot     VI  Import 
Terminal  1  Flow    II  Export  1 
Terminal  2  Pot     V2  Import 
Terminal  2  Flow    12  Export  1 
Parameter   R  le-15 
Function    resistor 
Structural  Jacobian  All 
DD 
DD 
end 

end 

% 

device  INDUCTOR 

Terminal  1  Pot     VI  Import 
Terminal  1  Flow    II  Export  1 
Terminal  2  Pot     V2  Import 
Terminal  2  Flow    12  Export  1 
Parameter   L  le-15 
Function    inductor 
Structural  Jacobian  All 
LL 
LL 
end 

end 

% 

device  CAPACITOR 

Terminal  1  Pot     VI  Export 
Terminal  1  Flow    II  Export  1 
Terminal  2  Pot     V2  Import 
Terminal  2  Flow    12  Import  1 
Parameter   C  le-15 
Function    capacitor 
Structural  Jacobian  All 
IL 
OD 
end 

end 

% 

device  VDC  SOURCE 

Terminal  1  Pot     VI  Export 
Terminal  1  Flow    II  Export  1 
Terminal  2  Pot     V2  Import 
Terminal  2  Flow    12  Import  1 
Parameter   VS  1.0 
Function   vdc  src 
Structural  Jacobian  All 
10 
OD 
end 

end 

% 

device  REFERENCE 

Terminal  Gnd  Pot   V0  Export 
Terminal  Gnd  Flow  10  Import  0 
Parameter   Vref  0.0 
Structural  Jacobian  ALL 

0 
end 

end 

% 

%  include  load  flow  definitions 

include  loadflow.def 

% 

%  include  rotating  machinery  IED  Models 

include  powersys.def 

% 

%  include  other  circuit  elements 

include  circ  elm. def 
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4.4.1  DEBUG 

The  DEBUG  command  is  always  a  single-line  command  and  results  in  the  display  of 
debug  information  for  a  specified  routine  during  the  execution  of  WAVESIM. 

Command  Description 

DEBUG   init_devices  Print  Info  on  Initial  System  Parameters 

DEBUG  read_device_def     Print  Info  on  what  is  read  from  device  .  def 

4.4.2  DEVICE 

DEVICE  is  always  a  multi-line  command.    The  command  must  be  entered  in  the 
following  format: 

DEVICE    Device_Type 

where: 

Device_Type  Device  Type  Name  (must  be  unique) 

The  Device  Type  Name  is  used  to  correlate  a  given  device  in  an  input  file  with  the 
properties  of  the  device  as  specified  here.  The  subordinate  commands  for  DEVICE  are: 

TERMINAL  Specify  Terminal  Variable  Properties 

PARAMETER  Specify  Parameters 

STATE  Specify  States 

FUNCTION  Specify  MATLAB  function 

STRUCTURAL   JACOB  IAN   Specify  Structural  Jacobian 

The  last  line  of  the  command  group  must  begin  with  the  key-word  END 
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4.4.2.1  DEVICE :  TERMINAL 

The  TERMINAL  subordinate  command  defines  the  properties  of  the  variables 
associated  with  a  terminal.  If  the  Terminal  is  a  normal  terminal,  both  the  flow  and 
potential  variables  need  definitions.  Flow  variables  also  require  a  KCL  group  number 
KCL  which  corresponds  to  the  group  of  terminals  for  which  KCL  can  be  written  internally 
to  the  device.  If  the  flow  variable  does  not  belong  to  a  KCL  group,  its  value  should  be  0. 
Variable  are  IMPORT  is  they  are  a  resource  to  the  device  and  are  EXPORT  if  they  are  a 
product  of  the  device.  The  total  number  of  export  variables  associated  with  normal  nodes 
must  equal  the  total  number  of  import  variables  associated  with  normal  nodes. 

Normal  Node  potentials  are  defined  by  either 

TERMINAL    Terminal   Name  POTENTIAL    Variable  Name  EXPORT 


or 


TERMINAL    Terminal    Name  POTENTIAL    Variable  Name   IMPORT 


Normal  Node  flows  are  defined  by  either 

TERMINAL  Termlnal_Name   FLOW  Varlable_Name   EXPORT  KCL 
or 

TERMINAL  Termlnal_Name   FLOW  VarlableJName   IMPORT  KCL 

Information  Node  potentials  are  defined  by  either 

TERMINAL    Terminal    Name    INFORMATION    Variable   Name  EXPORT 


or 


TERMINAL    Terminal   Name   INFORMATION   Variable  Name    IMPORT 


Where 

Termlnal_Name 
Varl  abi  e__Name 
KCL 


One  word  name  for  Terminal 
One  word  name  for  Variable 
KCL  Group  Number  (0  if  none) 
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4.4.2.2  DEVICE :    PARAMETER 

The  PARAMETER  subordinate  command  defines  the  parameters  of  the  device  and 
optionally,  declares  the  default  values  for  the  parameters.  Parameters  can  either  be  single 
valued  or  a  matrix.  A  single  valued  parameter  is  defined  by: 

PARAMETER  Parameter_Name  Default_Value 

where 

Parameter__Name  One  word  name  for  Parameter 

Default_Value  Optional  Default  Value  for  Parameter 

Matrix  parameters  for  which  which  no  default  values  are  provided  are  defined  by: 
PARAMETER  Parameter_Name  MATRIX   Nbr_Row  Nbr_Col 

where 

Nbr_Row  Number  of  rows  in  Matrix 

0  should  never  be  used 

-1  indicates  variable  dimensioned 


Nbr   Col 


Number  of  columns  in  Matrix 
0  should  never  be  used 
-1  indicates  variable  dimensioned 


Matrix  parameters  for  which  which  default  values  are  provided  are  defined  by: 

PARAMETER  Parameter_Name       MATRIX  Nbr_Row      NbrjCol 
DEFAULT 

Defa  ul  t_Ma  trix 

END 


where 


Default   Matrix 


Default  Matrix  values,  Each  matrix  row  should 
be  entered  one  line  at  a  time  with  columns 
separated  by  spaces. 
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4.4.2.3  DEVICE :    STATE 

The  STATE  subordinate  command  defines  the  states  of  the  device  and  optionally, 
declares  the  default  initial  values  for  the  states.  States  are  defined  by: 

STATE    State_Name  Default_Value 

where 

State_Name  One  word  name  for  State 

Default_Value  Optional  Default  Initial  Value  for  State 

4.4.2.4  DEVICE:  FUNCTION 

The  FUNCTION  subordinate  command  is  mandatory  and  defines  the  MATLAB 
function  which  defines  the  device  constitutive  equations.  The  MATLAB  function  is 
specified  by: 

FUNCTION   MATLAB_Function 

where 

MATLAB  Function  MATLAB  Function  name 
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4.4.2.5  DEVICE  :  STRUCTURAL  JACOBIAN 

The  STRUCTURAL  JACOBIAN  subordinate  command  defines  the  structural 
jacobian  matrix  of  the  device  for  1  or  for  all  of  the  waveform  types.  The  structural 
jacobian  for  all  waveform  types  is  specified  by: 

STRUCTURAL  JACOBIAN  ALL 
Struct  ural_Jacob± an 
END 


where 


Structural_Jacob±an   Structural      Jacobian      Matrix.      The      Rows 

correspond  to  Export  Variables  ordered 
according  to  the  order  of  definition.  Similarly, 
the  Columns  correspond  to  Import  Variables 
ordered  according  to  the  order  of  definition. 
The  elements  are  Structural  Jacobian  Codes 
detailed  below. 

The  structural  jacobian  for  one  particular  waveform  type  is  specified  by: 

STRUCTURAL   JACOBIAN    Waveform_Type 
Structural_Jacobian 
END 


where 


Wa ve form_  Type 


Waveform  Type  Code  the  structural  jacobian  is 
defined  for 
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Structural  Jacobian  Codes 


Code 

Type  of  Matrix 

0 

Zero  Matrix  (all  elements  are  always  zero) 

I 

Identity  Matrix  (always  the  identity  matrix) 

D 

Diagonal  Matrix  (always  a  linear  main  diagonal  matrix) 

L 

Linear  Matrix  (The  elements  are  always  constant) 

A 

Nonlinear  AC  Matrix  (see  Note  1) 

N 

Nonlinear  Matrix  (The  elements  may  not  be  constants) 

U 

Unknown  (The  dependence  is  unknown  (treat  as  nonlinear)) 

Note  1:  An  AC  Matrix  is  one  for  which  the  constant  component  of  the  export  variable 
depends  only  on  the  constant  component  of  the  import  variable.  The  other 
components  of  the  export  variable  can  not  depend  on  the  constant  component  of  the 
import  variable  but  are  not  restricted  in  any  other  way. 

Waveform  Type  Codes 


Waveform  Type 

Code 

Undefined 

0 

Data  Series 

1 

Fourier  Series 

2 

Legendre  Series 

3 

Polynomials 

4 

Matlab  Polynomials 

5 

Chebyshev  Series 

6 
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4.4.3  INCLUDE 

INCLUDE  is  always  a  single-line  command.    The  command  must  be  entered  in  the 
following  format: 

INCLUDE   F±le_Name 

where: 

File_Name  Name  of  the  file  to  include. 

The  contents  of  the  included  file  are  inserted  at  the  location  of  the  INCLUDE 
command. 
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4.5  Adding  devices 

Adding  New  devices  to  WAVESEvI  requires  the  creation  of  a  MATLAB  M-file 
defining  the  device  constitutive  equations  and  the  addition  of  an  entry  in  the  device  .  def 
file. 

4.5.1  MATLAB  M-FILE 

Creating  a  MATLAB  M-FILE  for  generating  a  new  device  requires  adherence  to  a 
strict  function  argument  list  format.  The  following  header  indicates  the  format  required  by 
WAVESIM: 

function  [e,  Jacob,  si,  ttl]  =  function1  (stype,  i , par , mparl2 , mpar2? ,  sO,  tt,  alpha) 

% 

%  FUNCTION 

% 

%   VERSION  2.5  of  19  April  1991 

%   (C)  Copyright  1990,  1991   by  Norbert  H.  Doerry 

% 

%   [e  ,  Jacob,  si,  ttl]  =  function  (stype, i, par, s0,tt,  alpha) 

% 

%  FUNCTION   creates  the  values  and  jacobian  matrix  for  a  FUNCTION 

% 

% 

%    stype  =  1  data  points 

%  =2  fourier  series 

%  =3  legendre  series 

%  =4  polynomial 

%  =5  MATLAB  Polynomials 

%  =6  chebyshev  series 

% 

%    i      =  [il    i2    . . .]    where 

%  il,    i2,     . . .    are  column  vectors  of  import  variables 

% 

%    par    =  [pi   p2    . . . ]  where 

%  pi      =  parameter_l 

%  p2      =  parameter_2 

% 

% 

%    mparl   =  matrix  parameter  parameter_Ml 

%    mpar2   =  matrix  paraemter  parameter_M2 

% 

%    sO     =  [S0_1   S0_2    ...]  where 

%  S0_1      =   state_l    value  at  tO 

%  S0_2     =   state_2   value  at  tO 

% 

% 

%    tt       [tO  tl  dtave]  where 

%  tO      =  initial  time  of  the  interval 

%  tl      =  final  time  of  the  interval 

%  dtave   =  averaging  increment 

% 

%    alpha  =  continuation  parameter 

% 
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%    e      =  [el    e2    . . .]    where 

%  el,    e2,     . . .    are  column  vectors  of  export  variables 

% 

%     Jacob  =  Jacobian  matrix  of  e  with  respect  to  i 

% 

%    si       [Sl_l    Sl_2    ...]    where 

%  sl_1      =  state_l   value  at  tl 

%  Sl_2      =   state_2   value  at  tl 

% 

% 

% 

%    ttl    =  [ntl  ntt]  where 

%  ntl   =  recommended  recomputation  time  this  interval 

%  ntt   =  recommended  ending  time  next  interval 

% 

Note  1:  function  is  the  name  of  the  function  defining  the  device.  The  MATLAB  M-FILE 
should  be  called  function .  m. 

Note  2:  mparl,  mpar2,  etc.  are  only  specified  if  the  device  as  defined  in  device .  def 
has  matrix  parameters. 
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Example  MATLAB  M-File 

function  [e  ,  Jacob  ,  si,  ttl]  =  resistor  (stype, i, par,  sO,  tt,  alpha) 

% 

%   RESISTOR 

% 

%   VERSION  1.6  of  25  February  1991 

%   (C)  Copyright  1990,1991  by  Norbert  H.  Doerry 

% 

%   [e  ,  Jacob,  si,  ttl]  =  resistor  (stype, i, par, sO, tt, alpha) 

% 

%   resistor  creates  the  values  and  jacobian  matrix  for  a  resistor 

% 

% 

%    stype  =  1  data  points 

%  =2  fourier  series 

%  =3  legendre  series 

%  =4  polynomial 

% 

%    i      =  [vl  v2]  where  vl  and  v2  are  column  vectors 

%    par    =  [R]      where  R  is  the  resistance 

%    sO     =  [] 

%    tt     =  [tO  tl  dt] 

%  tO     =  initial  time  of  the  interval 

%  tl     =  final  time  of  the  interval 

%  dt     =  averaging  time  interval 

%    alpha  =  continuation  parameter 

% 

%    e      =  [il  i2]  where  il  and  i2  are  column  vectors 

%     Jacob  =  Jacobian  matrix  of  e  with  respect  to  i 

%    si     =  [] 

%    ttl    =  [ntl  ntt]  where 

%  ntl  recommended  recomputation  time  this  interval 

%  ntt  recommended  ending  time  next  interval 

% 

%    structural  jacobian 

% 

%         D  D 

%         D  D 

% 

n  =  size  (i) ; 

n(2)  =  []; 

tO  =  tt  (1)  ; 

tl  -  tt  (2)  ; 

dt  =  tt  (3) ; 

% 

ttl  =  [tl  tO]  ; 

% 

R  =  par  (1) ; 

% 

si  =  []; 

% 

vl  =  i(:,l); 

v2  =  i(:,2); 

% 

il  =  (vl  -  v2)  /  R; 

i2  =  -  il; 

% 

% 

e  =  [il  12]; 

% 

% 

ii  =  eye (n) ; 

% 

Jacob  =  [  ii  /  R  -ii  /  R  ;  -  ii  /  R  ii  /  R  ]; 

% 
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4.5.2  device  .  def  File 

A  DEVICE  entry  must  be  made  in  the  device  .  def  file  as  described  in  a  previous 
section.  Here  is  an  example  of  the  entry  made  for  the  resistor: 

% 

DEVICE  RESISTOR 
% 

TERMINAL  1  POTENTIAL  VI  IMPORT 

TERMINAL  1  FLOW       II  EXPORT  1 

TERMINAL  2  POTENTIAL  V2  IMPORT 

TERMINAL  2  FLOW       I 2  EXPORT  1 

PARAMETER  R  le-15 

FUNCTION  resistor 

STRUCTURAL  JACOBIAN  ALL 
DD 
DD 

END 
END 

Note:  a  device  can  be  have  multiple  entries  in  device. def  to  reflect  different 
default  state  initial  values  and  default  parameter  values.  For  example,  one  may  desire  to 
create  a  model  of  a  1 000  ohm  resistor: 

% 

DEVICE  1K_RESIST0R 
% 

TERMINAL  1  POTENTIAL  VI  IMPORT 

TERMINAL  1  FLOW       II  EXPORT  1 

TERMINAL  2  POTENTIAL  V2  IMPORT 

TERMINAL  2  FLOW       I 2  EXPORT  1 

PARAMETER  R  1000 

FUNCTION  resistor 

STRUCTURAL  JACOBIAN  ALL 
DD 
DD 

END 
END 

In  this  manner,  one  can  develop  devices  which  reflect  the  specific  operating 
parameter  of  a  particular  model.  A  Gas  Turbine  model  for  example,  could  be  called 
GT_501K-17  and  have  all  the  parameters  prespecified  for  an  Allison  501K-17  Gas 
Turbine. 
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4.6  Adding  Waveform  Types 

Adding  a  new  waveform  type  requires: 

1 .  Assignment  of  a  waveform  type  code. 

2.  Writing  MATLAB  M-File  functions  for  converting  to  and  from  the  other 
waveform  types. 

3.  Modification  of  wconvert .  m 

4.  Writing  MATLAB  M-FILE  functions  for  accomplishing  the  waveform 
operations  required  by  the  devices 

5.  Modificaiton  of  wf  unction .  m  files 
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4.6.1  Conversion  M-Files 

Here  is  an  example  of  a  conversion  M-File  for  converting  a  Legendre  Series  into  a 
Polynomial: 

function  [poly,  Jacob]  =  leg_poly (leg, n) 

% 

%  [poly,  Jacob]  =  leg_poly (leg, n) 

% 

%  Norbert  H.  Doerry 

%  Revision  1.1   21  November  1990 

% 

%  LEG_POLY  converts  a  Legendre  Series  to  a  Normal  Polynomial 

%  leg   =  vector  of  Legendre  Series  Coefficients  in  ascending 

%  order 

%  n      =  size  of  polynomial  array  to  create 

% 

%  poly   =  answer 

%  Jacob  =  partial  derivative  of  poly  wrt  leg 

% 

nl  =  size (leg)  ; 

nl(2)  =  []; 

% 

if  n  <=  0 

n2  =  nl; 
else 

n2  =  n; 
end 
% 

%  build  the  jacobian 
% 

Jacob  =  zeros (n2,  nl) ; 
% 
if  nl  >  n2 

nn  =  n2; 
else 

nn  =  nl; 
end 
% 
for  i=l:nn 

Jacob (l:i,i)  =  legendre (i-1) ; 
end 
% 

poly  =  Jacob  *  leg; 
% 
% 
% 
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Note  that  a  jacobian  matrix  must  be  specified  for  each  result  with  respect  to  each 
argument.  Here  is  the  current  version  of  wconvert .  m  which  is  the  normal  method  for 
accessing  the  conversion  routines: 

function  [w2, Jacob]  =  wconvert (wl,n,sl,s2) 

% 

%   WCONVERT 

% 

%   VERSION  1.3  of  26  March  1991 

%   (C)  Copyright  1990.1991  by  Norbert  H.  Doerry 

% 

%   [w2, Jacob]  =  wconvert (wl,n,sl,s2) 

% 

% 

%   WCONVERT  converts  a  waveform  of  one  type  to  another  type  and 

%        also  returns  the  jacobian  of  the  conversion: 

% 

%        w      =  input  waveform 

%        n      =  number  of  points  in  output  waveform 

% 

%        si     =  type  of  input  waveform 

%  =1  data  points 

%  =2  fourier  series 

%  =3  legendre  series 

%  =4  polynomial 

%  =5  for  matlab  polynomial  (not  implemented  yet) 

%  =6  chebyshev  series 

% 

%        s2     =  type  of  output  waveform 

% 

nl  =  size (wl) ; 
nl(2)  =  []; 
if  n  <  1 

n2  =  nl; 
else 

n2  =  n; 
end 
% 
% 
if  si  <  1  |  si  >  6 

'Illegal  waveform  type' 

si 

return; 
end 
if  s2  <  1  |  s2  >  6 

'Illegal  waveform  type' 

s2 

return; 
end 
if  si  ==  5  |  s2  ==  5 

'Illegal  waveform  type' 

s2 

return; 
end 
% 
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% 

if  si  —  1 
if  s2  ==  1 

[w2,  Jacob]  =  datadata (wl, n2) ; 

return; 
elseif  s2  ==  2 

[w2,  Jacob]  =  datafour (wl, n2) ; 

return; 
elseif  s2  ==  3 

[w2,  Jacob]  =  data_leg (wl,  n2)  ; 

return; 
elseif  s2  ==  4 

[w2,  Jacob]  =  datapoly (wl, n2) ; 

return; 
else 

[w2,  Jacob]  =  datacheb (wl, n2) ; 

return; 
end 

% 

elseif  si  ==  2 
if  s2  ==  1 

[w2,  Jacob]  =  fourdata (wl, n2) ; 

return; 
elseif  s2  ==  2 

[w2,  Jacob]  =  fourfour (wl, n2) ; 

return; 
elseif  s2  ==  3 

[w2,  Jacob]  =  four_leg (wl, n2) ; 

return; 
elseif  s2  ==  4 

[w2,  Jacob]  =  fourpoly (wl, n2) ; 

return; 
else 

[w3,  j31     =  fourpoly  (wl, n2)  ; 

(w2,  3JJ     =  polycheb (w3, n2) ; 

;)acob  =  jj  *  j3; 

return; 
end 

% 

elseif  si  ==  3 
if  s2  =  1 

[w2,  Jacob]  =  leg_data (wl, n2) ; 

return; 
elseif  s2  ==  2 

[w2,  Jacob]  =  leg_four (wl, n2) ; 

return; 
elseif  s2  ==  3 

[w2,  Jacob]  =  leg_leg (wl,  n2)  ; 

return; 
elseif  s2  ==  4 

[w2,  Jacob]  =  leg_poly (wl, n2) ; 

return; 
else 

[w2,  Jacob]  =  leg_cheb (wl, n2) ; 

return; 
end 

% 

elseif   si  ==  4 
if  s2  ==  1 

[w2,  Jacob]  =  polydata (wl, n2)  ; 

return; 
elseif  s2  ==  2 

[w2,  Jacob]  =  polyf our (wl, n2) ; 

return; 
elseif  s2  ==  3 

[w2,  Jacob]  =  poly_leg (wl,  n2)  ; 

return; 
elseif  s2  ==  4 

[w2,  Jacob]  =  polypoly (wl, n2) ; 

return; 
else 

[w2,  Jacob]  =  polycheb  (wl, n2) ; 

return; 
end 
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else 

if  s2  =  1 

[w2, Jacob]  =  chebdata (wl, n2) ; 

return; 
elseif  s2  ==  2 

[w3,j3]     =  chebpoly  (wl, 0) ; 

[w2,nj]     =  polyf our (w3, n2) ; 

jacob   =  jj  *  j3; 

return; 
elseif  s2  ==  3 

[w2, Jacob]  =  cheb_leg (wl, n2) ; 

return; 
elseif  s2  ==  4 

[w2, Jacob]  =  chebpoly (wl, n2) ; 

return; 
else 

[w2, Jacob]  =  leg_leg (wl, n2) ; 

return; 
end 
end 
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4.6.2  Waveform  Functions 

Waveform  functions  are  defined  in  a  similar  manner  to  the  conversion  files.   Here  is 
an  example  of  a  MATLAB  M-File  for  integrating  a  polynomial: 

function  [p2  ,  Jacob]  =  poly  int(pl,n,c) 

% 

% 

%   [p2  ,  Jacob]  =  poly_int (pi, n, c) 

% 

%  Norbert  H.  Doerry 

%  Revision  1.0  of  b  December  1990 

% 

%    pi  =  input  polynomial 

%    n   =  number  of  points  in  p2 

%    c   =  integration  constant 

% 

%    p2  =  integeral  of  pi 

%     Jacob  =  partial  of  p2  with  respect  to  pi 

% 

% 

%    POLY  INT  integrates  a  given  polynomial  and  converts  the 

%    resuTt  to  another  polynomial  of  size  n 

% 

% 

nl  =  size (pi) ; 

nl(2)  =  []; 

% 

%  Error  checking 

% 

if  n  <  2 

n2  =  nl; 
else 

n2  =  n  ; 
end 
% 
if  nl  <  1 

p2  =  []; 

return; 

end 
% 

%  calculate  the  integration  matrix 
% 
jl  =  zeros (nl+1, nl) ; 

for  i  =  1  :  nl 

jl(i+l,i)  =  1  /  i; 
end 
% 

%  xx  is  (-1)"  (n-1) 
% 

xx  =  ones (1, n2) ; 
for  i  =  2  :  n2 

xx(l,i)  =  -  xx(l,i-l); 
end 

% 

%   calculate  the  indefinite  integral  of  the  polynomial 

% 

pil  =  jl  *  pi; 

%  convert  to  a  polynomial  of  the  right  size 

% 

[p2,j2]  =  polypoly (pil,n2) ; 

jS  -  ii  •  », 

%  convert  to  a  definite  integral  by  adding  the  constant  of 

%    integration  and  subtracting  the  value  of  the  indefinite 

%    integral  at  x  =  -1 

% 

Jacob  =  j3  -  [xx  *  j3  ;  zeros  (n2-l,  nl)  ]  ; 

p2(l,l)  =  P2(l,l)  -  xx  *  j3  *  pi  +  c(l,l); 
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Normally,  a  user  would  call  w_int  to  integrate  a  waveform: 


function    [w2    ,     Jacob]    =   w    int (wl, n, si, c) 

%  ~ 

%    W    INT 

%       ~ 

%  Version  1.2  of  19  April  1991 

%  (C)  Copyright  1991  by  Norbert  H.  Doerry 

% 

%   [w2,  Jacob]  =  w  int (wl,  n, si, c) 

%  ~ 

%   W  INT  integrates  a  waveform  and  returns  the  result  into  a  waveform  of 

%    "the  same  type  but  of  possible  different  length 

% 

%    wl   =  input  waveform 

%     n   =  number  of  points  in  output  waveform 

%    si   =  type  of  waveform 

%        =1  data  points 

%        =2  fourier  series 

%        =3  legendre  series 

%        =  4  polynomial 

%        =5  for  matlab  polynomial 

%        =6  for  chebyshev  series 

% 

%     c   =  constant  of  integration 

% 

%    w2   =   waveform  which  is  integral  of  wl 

%     Jacob  =  jacobian  of  w2  with  respect  to  wl 

nl  =  size  (wl) ; 
nl(2)  =  []; 
if  n  <  1 

n2  =  nl; 
else 

n2  =  n; 
end 
% 

%  check  for  illegal  waveform  type 
% 
if  si  <  1  |  si  >  6 

'Illegal  waveform  type' 

si 

return; 

end 

if  si  ==  1 

[w2  ,  Jacob]  =  data  int (wl, n2, c) ; 
%  ~ 

elseif  si  ==  2 

[w2  ,  Jacob]  =  four  int (wl, n2, c) ; 
%  ~ 

elseif  si  ==  3 

>3,  j3]  =  legpoly (wl, nl) ; 
w4,  j4]  =  poly_int (w3, n2, c) ; 
w2,  j2]    =   poly_leg (w4, n2) ; 

Jacob  =  j2  *  j4  *  j3; 
% 
elseif  si  ==  4 

[w2  ,  Jacob]  =  poly  int (wl, n2, c) ; 
%  ~ 

elseif  si  ==  5 

[w3,  j3]  =  mplypoly  (wl,  nl)  ; 

[w4,  ^4]  =  poly_int  (w3,  n2,  c)  ; 

[w2,  3 2 J  =  polymply  (w4, n2)  ; 

Jacob  =  j2  *  j4  *  ^3; 
% 
elseif  si  ==  6 

w3,  j31  =  chebpoly (wl, nl) ; 
w4,     ^4]  =  poly  int (w3, n2, c) ; 

>2,  j2]    =   polycheb (w4, n2) ; 

Jacob  =  j2  *  j4  *  j3; 
% 
else 

' error' 
end 
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Notice  how  the  waveform  conversion  routines  are  used  to  implement  waveform 
operations  which  have  not  yet  been  defined  for  a  given  waveform  type. 
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Chapter  5  Simulation  Results 

As  a  demonstration  of  the  capabilities  of  WAVESIM,  the  results  of  three  simulations 
are  presented  here.  While  these  simulations  are  relatively  simple,  they  include  the  important 
features  of  more  difficult  simulations,  yet  are  not  so  complicated  as  to  be  unverifiable.  The 
first  simulation  of  a  simple  electical  circuit  containing  only  linear  devices  verifies  the  ability 
of  WAVESIM  to  construct  a  viable  system  and  limit  truncation  error  by  controlling  the 
waveform  interval  and  number  of  coefficients.  The  second  simulation  increases  the 
complexity  by  including  a  nonlinear  device  and  provides  a  good  test  of  the  Newton-Raphson 
solver.  The  third  and  final  simulation  demonstrates  the  use  of  a  continuation  parameter  to 
improve  the  region  of  convergence  of  the  simulation. 
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5.1  Linear  Electrical  Circuit 

To  demonstrate  WAVESEM's  ability  to  solve  linear  circuit  problems,  the  circuit 
shown  in  figure  5.1-1  was  simulated.  Initially,  both  capacitors  have  zero  charge  and  the 
inductor  currents  are  zero  as  well.  The  transients  of  the  capacitor  voltages  and  current  are 
shown  in  figure  5.1-2.  The  simulation  was  conducted  using  Legendre  Series  with  the  20 
second  simulation  time  split  up  among  23  intervals.  Eleven  intervals  were  rejected  due  to 
excessive  truncation  error. 

Figure  5.1-1:  Linear  Electrical  Circuit:  Schematic 


©vs=i 


Ll=l 


Cl  =  l 


L2=l 


C2  =  l 


The  results  shown  in  figure  5.1-2  are  identical  (to  working  precision)  to  an  analytic 
solution  of  the  circuit. 

Figure  5.1-2:  Linear  Electrical  Circuit:  Simulation  Results 


rcrc.m  using  LEGENDRE  SERIES  n  =  7 
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The  input  file  specifying  the  system  is  given  by: 

Input  File  for  Linear  Electrical  Circuit 


% 

%  rcrc.in 

% 

device  VDC  SOURCE 

Vs 

TERMINAL 

1 

1 

TERMINAL 

2 

0 

PARAMETER  VS 

1.0 

END 

% 

device  RESISTOR 

Rl 

TERMINAL 

1 

1 

TERMINAL 

2 

2 

PARAMETER 

R 

0.1 

END 

% 

device  RESISTOR 

R2 

TERMINAL 

1 

2 

TERMINAL 

2 

3 

PARAMETER 

R 

1.0 

END 

% 

device  INDUCTOR 

LI 

TERMINAL 

1 

2 

TERMINAL 

2 

0 

PARAMETER 

L 

1.0 

END 

% 

device  INDUCTOR 

L2 

TERMINAL 

1 

3 

TERMINAL 

2 

0 

PARAMETER 

L 

1.0 

END 

% 

device  CAPACITOR 

CI 

TERMINAL 

1 

2 

TERMINAL 

2 

0 

PARAMETER 

C 

1.0 

END 

% 

device  CAPACITOR 

C2 

TERMINAL 

1 

3 

TERMINAL 

2 

0 

PARAMETER 

C 

1.0 

END 

% 

% 

default 

Gmin  0 

Rmin  0 

r import  NO 

check  both 
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error  eqn  kcl 

5e- 

•3 

error  eqn  pot 

5e- 

■3 

error  var  node 

5e- 

■3 

error  var  flow 

5e- 

■3 

error  mult  kcl 

10. 

0 

error  mult  pot 

10. 

0 

error  mult  node 

10. 

0 

error  mult  flow 

10. 

0 

max  count  10 

max  int  count  6 

alpha  init  1 . 0 

alpha  inc  init  . 

25 

alpha  inc  min 

.05 

alpha  inc  max 

.50 

diverge  start  3 

diverge  max  cnt 

2 

diverge  error  mult 

10.0 

waveform  content  max  .001 

waveform  content  nh 

»r  2 

range  max  .005 

scale  potential 

l.C 

i 

scale  flow 

l.C 

i 

stype  3 

nbr  coef  7 

nbr  coef  min  6 

nbr  coef  max  14 

nbr  data  20 

END 

% 

% 

time 

dt  min  .01 
dt  max  2 . 0 
dt  opt  .250 
dt  init  .5 
dt  ave  0 . 0 
start    0.0 
finish  20.0 
END 

% 

plot 

potential  Rl  2 
node  3 
flow  C2  1 
END 

Figure  5.1-3  shows  the  time  increment  and  number  of  coefficients  used  for  each  of  the 
intervals.  Once  the  transients  start  to  decay,  the  number  of  coefficients  are  decreased  to  the 
minimum  allowed. 
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Figure  5.1-3  Truncation  Error  Control 

Interval 

Ending  Time  (sec) 

Number  of 
Coefficients 

1 

0.25 

7 

2 

0.50 

7 

3 

0.75 

7 

4 

1.25 

7 

5 

2.25 

7 

6 

3.25 

6 

7 

4.25 

6 

8 

4.75 

6 

9 

5.25 

6 

10 

6.25 

6 

11 

7.25 

6 

12 

8.25 

6 

13 

8.75 

6 

14 

9.25 

6 

15 

10.25 

6 

16 

11.25 

6 

17 

12.25 

6 

18 

14.25 

6 

19 

15.25 

6 

20 

16.25 

6 

21 

17.25 

6 

22 

18.25 

6 

23 

20.00 

6 
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5.2  Nonlinear  Electrical  Circuit 


To  demonstrate  WAVESEM's  ability  to  solve  nonlinear  circuit  problems,  the  circuit 
shown  in  figure  5.2-1  was  simulated.  Initially,  the  inductor  current  is  zero.  As  the  inductor 
current  builds  up,  its  voltage  is  clamped  by  the  diode  to  one  diode  drop  above  1  volt  and  its 
current  ramps  up  almost  linearly.  When  the  inductor  voltage  falls  far  enough  to  turn  the 
diode  off,  the  current  and  voltage  both  show  a  normal  exponential  transient  behavior. 
Figure  5.2-2  shows  the  inductor  voltage  and  current  as  a  function  of  time. 

Figure  5.2-1  Nonlinear  Electrical  Circuit:  Schematic 
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©  Vsl  =  10 


LI 


1 
Vs2 


,6 


The  results  shown  in  figure  5.2-2  were  calculated  using  Legendre  Series  over  seven 
time  intervals.  Five  additional  intervals  were  rejected  due  to  excessive  truncation  error. 
These  results  match  closely  an  analytic  solution  to  the  circuit. 
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Figure  5.2-2  Nonlinear  Electrical  Circuit:  Simulation  Results 

rd.m  using  LEGENDRE  SERIES  n  =  7 


The  input  file  specifying  the  system  is  given  by: 

Input  File  for  Nonlinear  Electrical  Circuit 


% 

%    rd.in 

% 

device  VDC_SOURCE  Vsl 
TERMINAL    1   1 
TERMINAL    2   0 
PARAMETER   VS  10.0 
END 

% 

device  RESISTOR    Rl 

TERMINAL  1  1 
TERMINAL  2  2 
PARAMETER  R  1.0 
END 


device  INDUCTOR 

LI 

TERMINAL 

1 

2 

TERMINAL 

2 

0 

PARAMETER 

L 

1.0 

END 

% 

device  DIODE1 

Dl 

TERMINAL 

1 

2 

TERMINAL 

2 

3 

END 
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device  VDC_SOURCE  Vs2 
TERMINAL    1     3 
TERMINAL    2     0 
PARAMETER   VS  1 . 0 
END 


% 

default 

Gmin  0 
Rmin  0 
rimport  NO 
check  both 

error  eqn  kcl 

5e-3 

error  eqn  pot 

5e-3 

error  var  node 

5e-3 

error  var  flow 

5e-3 

error  mult  kcl 

10.0 

error  mult  pot 

10.0 

error  mult  node 

10.0 

error  mult  flow 

10.0 

max  count  10 

max  int  count  6 

alpha  init  1  .  0 

alpha  inc  init 

25 

alpha  inc  min 

05 

alpha  inc  max 

50 

diverge  start  3 

diverge  max  cnt 

2 

diverge  error  mult  10.0 

waveform  content 

:  max  .001 

waveform  content 

.  nbr  2 

range  max  .005 

scale  potential 

1.0 

scale  flow 

1.0 

wtype  3 

nbr  coef  7 

nbr  coef  min  7 

nbr  coef  max  10 

nbr  data  20 

END 

time 

dt  min  .01 
dt  max  5 . 0 
dt  opt  .250 
dt  init  5 
dt  ave   .01 
start    0.0 
finish  10.0 
END 


% 
plot 


potential  Rl  2 
flow  LI  1 
END 
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Figure  5.2-3  Truncation  Error  Control 


Interval  Ending  Time  (sec)  Number  of 

Coefficients 

1  5.00  7 

2  6.25  7 

3  6.4063  7 

4  6.7188  7 

5  7.3438  7 

6  8.5938  7 

7  10.0  7 
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5.3  Nonlinear  Mechanical  System 

To  demonstrate  the  ability  of  WAVESIM  to  use  continuation  parameters  in  simulating 
nonlinear  mechanical  systems,  a  mechanical  power  train  was  modelled.  The  acceleration 
characteristic  of  a  ship  was  determined  for  a  propeller  rotating  at  a  constant  speed.  Figure 
5.3-1  shows  a  schematic  diagram  of  the  system. 

Figure  5.3-1  Nonlinear  Mechanical  System:  Schematic 


The  propeller  model  is  described  in  Appendix  F-8  while  the  ship  dynamics  model  is 
described  in  Appendix  F-9.  Figure  5.3-2  shows  the  parametric  curves  used  for  Cj{)  and 
Cg().  This  data  is  for  a  three  bladed  propeller  with  an  expanded  area  ratio  of  .5  and  an  H/D 
ratio  of  .6  [81]. 

Figure  5.3-3  shows  the  Residual  drag  coefficient  used  in  the  ship  dynamics  model. 
This  data  is  from  the  Taylor  Standard  Series  for  a  hull  with  beam  to  draft  ratio  of  3.0, 
Prismatic  Coefficient  (Cp)  of  .68,  and  Volumetric  coefficient  of  0.002.  The  Frictional  Drag 
Coeffient  was  calculated  using  the  standard  1 11 C  Line: 

QKJ-       -075      , 

A  (lOg10(*e)-2)2 
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Figure  5.3-2  Nonlinear  Mechanical  System:  Propeller  Characteristics 


3  Blade  Propeller  Curves  :  EAR  =  .5  :  H/D  =  .6 


-2-10  1  2 

Theta  =  atan2(Vp/nD)  radians 


Figure  5.3-3  Nonlinear  Mechanical  System:  Drag  Coefficient 
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Residual  Drag  Coefficient  vs  Fr 
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The  input  file  specifying  the  system  is  given  by: 

Input  File  for  Nonlinear  Mechanical  System 

% 

%  shipmol . in 

% 

%  Model  of  a  prime  mover  attached  to  prop  going  to  the  sea 

% 

device  NODE_REF  GT1 

TERMINAL  1  1 

PARAMETER  Vref  5.0 

END 
% 
device  PROP1  prop 

TERMINAL  SHAFT  1 

TERMINAL  WATER  2 

PARAMETER  D   10.0 

PARAMETER  w   0.0 
end 

% 

%  parameters  are  rough  ones  from  Sue  B  Gail 

% 

device  SHIPDYN1  ship 

TERMINAL  WATER  2 

PARAMETER  L  100 

PARAMETER  A  3300 

PARAMETER  M  15000000 

PARAMETER  Madd  1.05 

PARAMETER  Ca  0.0004 

STATE  Us  0 
end 

% 
Node  1 

SCALE  POTENTIAL  1 

SCALE  FLOW       le-4 

NAME  Propeller_Shaft 

Gmin  1 

END 
Node  2 

SCALE  POTENTIAL  1 

SCALE  FLOW       le-4 

NAME  Hydrodynamic_U_f orce 

END 


% 
default 


Gmin  0 

Rmin  0 

r import  NO 

check  eqn 

error  eqn  kcl    le-2 

error  eqn  pot    le-2 

error  var  node   le-2 

error  var  flow   le-2 

error  mult  kcl   10.0 

error  mult  pot   10.0 

error  mult  node  10.0 

error  mult  flow  10.0 

max  count  10 
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max  int  count  6 

alpha  init  0.5 

alpha  inc  init  .25 

alpha  inc  min   . 05 

alpha  inc  max   .50 

diverge  start  3 

diverge  max  cnt  2 

diverge  error  mult  10.0 

waveform  content  max  .005 

waveform  content  nbr  2 

range  max  .005 

scale  potential  1.0 

scale  flow       1 .  0 

stype  3 

nbr  coef  7 

nbr  coef  min  6 

nbr  coef  max  10 

nbr  data  20 

END 

% 
time 

dt  mi  n  .25 

dt  max  5 . 0 

dt  opt  1 . 0 

dt  init  2.0 

dt  ave  0.0 

start    0.0 

finish   7.25 

END 

% 

plot 

%  node  1  converted  to  RPM 

%  node  2  converted  to  Knots  (more  or  less) 

% 

node   1   9.5492966 

node   2   1.8 

flow  ship  WATER  le-5 

flow  prop  SHAFT  le-5 

END 


The  results  of  the  simulation  using  Legendre  Series  are  shown  in  figure  5.3-4.  The 
simulation  was  broken  into  24  intervals  shown  in  figure  5.3-5.  An  additional  25  intervals 
were  rejected  due  to  excessive  truncation  error.  For  each  iteration,  the  continuation 
parameter  was  initially  set  to  0.5.  This  value  helped  assure  the  initial  value  of  0  was  within 
the  convergence  region  of  the  nonlinear  blocks.  While  0.5  was  suitable  for  most  iterations, 
several  required  the  continuation  parameter  be  decremented  further  to  achieve  convergence. 
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Figure  5.3-4  Nonlinear  Mechanical  System:  Simulation  Results 

shipmo2.m  using  LEGENDRE  SERIES  n  =  7 


As  expected,  the  force  on  the  propeller  is  greatest  during  the  acceleration  of  the  ship. 
As  the  ship  accelerates,  the  increased  forward  velocity  on  the  ship  results  in  smaller  torques 
and  forces.  In  reality  it  is  doubtful  the  motor  would  be  capable  of  maintaining  a  constant 
RPM  during  the  acceleration  phase. 
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Figure  5.3-5  Tru 
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Chapter  6  Conclusions 

In  its  present  form,  WAVESEM  is  ideally  suited  for  testing  numerical  algorithms. 
While  it  is  capable  of  simulating  large  systems,  the  interpretive  nature  of  MATLAB  is  not 
numerically  efficient  enough  for  serious  simulations.  Careful  development  of  a  simulation 
environment  based  on  the  techniques  explored  in  WAVESEM  should  prove  effective  in 
solving  tightly  coupled  multirate  systems  of  lumped  parameter  models. 

The  simulation  environment  described  in  this  thesis  should  be  considered  a  framework 
for  future  developments.  Many  improvements  are  possible  and  desirable.  In  particular,  the 
following  areas  need  further  attention: 

Truncation  Error  Control 

The  present  method  for  controlling  truncation  error  is  heuristic  and  should  be 
examined  for  improvement.  Truncation  Error  propagation  should  be  examined  and 
given  a  theoretical  basis. 

Discontinuity  Time  Prediction 

The  accuracy  of  the  methods  used  in  WAVESIM  depend  partly  on  the  ability  to 
predict  discontinuities  and  force  them  to  occur  on  time  interval  boundaries.  The 
methods  used  in  current  models  are  crude  and  should  be  replaced  with  more  robust  and 
accurate  methods. 

Stability  Analysis 

WAVESIM  presently  does  not  perform  any  stability  analysis.  Since  WAVESIM 
abandons  the  standard  state  space  representation  of  the  system,  determining  the 
eigenstructure  of  the  system  is  not  easy.  A  stability  measure  based  on  the 
characteristics  of  individual  devices  would  fit  well  with  the  structure  of  WAVESIM 
and  would  be  quite  useful  in  the  design  of  distributed  controls. 

Smoothing  Operation 

The  smoothing  operator  for  removing  the  effects  of  high  frequency 
discontinuities  needs  to  be  examined  to  improve  its  efficiency.  How  long  to  make  the 
smoothing  interval  is  a  question  which  has  not  been  satisfactorily  answered. 

Partitioning  and  Relaxation 
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The  approach  WAVESEM  uses  for  developing  the  set  of  system  equations  is 
ideally  suited  for  use  with  relaxation  methods  if  the  system  is  weakly  coupled.  An 
extension  to  the  structural  Jacobian  to  include  matrix  norms  would  greatly  simply  the 
task  of  partitioning  the  system  into  a  set  of  weakly  coupled  blocks  which  internally  are 
strongly  coupled.  Each  individual  block  would  be  solved  using  Newton-Raphson  with 
the  system  solved  using  a  relaxation  technique.  Unfortunately,  the  process  of 
constructing  a  system  matrix  of  norms  from  device  matrix  norms  is  presently  not 
possible  because  arithmetic  operators  for  matrix  norms  have  not  been  identified. 

Overall,  WAVESEM  has  been  very  successful  in  developing  the  algorithms  for  building 
systems  in  terms  of  device  functions,  treating  waveforms  as  an  abstract  data  type,  and 
employing  the  structural  Jacobian  matrix  to  reduce  the  system  into  a  sequence  of  smaller 
blocks.  Much  work  remains,  but  the  foundation  of  a  waveform  based  simulator  capable  of 
handling  tightly  coupled  multirate  simulation  problems  is  contained  within  WAVESEM. 
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Appendix  A:  Glossary 
Block 


Continuation 
Parameter 


Device 


device. def 


Device  Jacobian 


A  subset  of  a  system's  equations  and  variables  which  must  be  solved 
simultaneously.  Blocks  are  organized  into  a  sequence  where 
variables  determined  in  a  previous  block  may  be  used  in  following 
blocks. 

A  technique  to  enlarge  the  convergence  region  of  a  nonlinear  system 
by  using  the  solution  to  a  linear  system  as  the  initial  guess  for  the 
solution  of  another  system  which  is  a  combination  of  the  linear  and 
nonlinear  systems.  The  process  is  repeated  with  each  iteration 
increasing  the  nonlinear  portion  until  the  solution  to  the  nonlinear 
system  is  determined.  The  continuation  parameter  determines  the 
relative  proportion  of  the  nonlinear  system:  0  for  the  linear  system 
and  1  for  the  desired  nonlinear  system. 

A  device  is  a  mathematical  model  of  a  physical  piece  of  equipment 
comprising  a  system.  Devices  interact  with  one  another  through 
interface  variables  which  are  associated  with  other  device  interface 
variables  through  terminals  connected  at  nodes.  The  equations 
describing  a  given  device  type  are  specified  in  the  device  definition. 
A  given  instance  of  a  device  also  has  associated  parameters  and 
nodal  connections. 

A  file  for  describing  a  device  definition.  Each  device  type  has  an 
entry  describing  the  device  type  name,  terminals,  states,  parameters, 
structural  Jacobian,  and  MATLAB  M-File  containing  the 
constitutive  equations. 

A  matrix  whose  elements  are  the  partial  derivatives  of  the  export 
variables  of  a  device  with  respect  to  the  device  import  variables. 


Device      Structural  A  matrix  describing  the  dependence  of  a  device's  export  variable 
Jacobian  Matrix  with  respect  to  the  import  variables.  The  dependence  is  specified  by 

a  matrix  whose  elements  are  a  code  indicating  if  the  dependence  is 

zero,  identity,  diagonal,  linear,  or  nonlinear. 


Export  Variable 


An  interface  variable  (either  a  potential  or  flow  variable)  of  a  device 
which  is  explicitly  defined  by  the  device  constitutive  equations.  A 
device  takes  import  variables  as  input  and  produces  export  variables. 
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Flow  Variable 


'mln 


Import  Variable 


Information 
Terminal 

Interface  Variable 


KCL 


KCL  Equation 


An  interface  variable  (either  an  export  or  import  variable)  associated 
with  a  normal  terminal  of  a  device  which  corresponds  to  a  quantity 
satisfying  Kirchhoffs  Current  Law  at  nodes.  Examples  of  flow 
variables  are  currents,  forces,  and  torques. 

A  modification  to  the  KCL  equations  at  a  node  corresponding  to  the 
insertion  of  a  conductance  to  the  0  potential.  Used  to  prevent 
singular  systems. 

An  interface  variable  (either  a  potential  or  flow  variable)  of  a  device 
which  is  implicitly  defined  by  the  device  constitutive  equations.  A 
device  takes  import  variables  as  input  and  produces  export  variables. 

A  terminal  of  a  device  having  only  a  potential  associated  with  it. 
Used  to  convey  energyless  information  between  devices. 

Variables  through  which  devices  communicate  energy  and 
information  transfer  to  other  devices.  Interface  variables  are 
associated  with  terminals,  can  be  classified  as  either  flow  or 
potential  variables  and  can  be  classified  as  either  import  or  export 
variables. 

Kirchhoffs  Current  Law  which  states  the  sum  of  the  flow  variables 
attached  to  a  node  is  zero. 

Equates  the  sum  of  the  flow  variables  attached  to  a  node  to  zero. 


KCL  Group  If  a  subset  of  a  device's  flow  variables  add  to  zero  by  definition, 

Number  then  the  elements  of  such  a  subset  have  a  device-unique  nonzero 

group  number.  Flow  variables  which  do  not  belong  to  such  a  subset 

have  a  0  KCL  Group  Number. 

KCL  Group   Numbers   are   used  to   determine  possible   singular 

systems  due  to  linear  dependence  of  system  KCL  equations. 


MATLAB  M-File 


Newton-Raphson 
Method 


Text  files  of  MATLAB  commands  for  creating  new  MATLAB 
functions  or  executing  scripts. 

An  iterative  technique  for  solving  systems  of  nonlinear  equations 
which  uses  the  Jacobian  Matrix  to  generate  corrections  to  the  system 
variables. 
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Node 


Normal  Terminal 

Parameter 

Potential 

Difference 

Equation 

Potential  Variable 


*mln 


Smoothing 
Operator 


State 


A  connection  point  for  connecting  terminals  of  one  or  more  devices. 
If  at  least  one  normal  terminal  is  attached,  the  node  is  a  normal  node 
and  a  system  KCL  equation  is  written  to  equate  the  sum  of  all  the 
attached  flow  variables  to  zero.  If  only  information  terminals  are 
attached  to  a  node,  the  node  is  an  information  node.  All  nodes  have 
an  associated  node  potential. 


A  terminal  having  both  a  potential  and  flow  variable, 
simulate  energy  transfer  between  devices. 


Used  to 


A  variable  which  does  not  change  throughout  the  simulation. 
Usually  refers  to  machine  ratings,  resistances,  time  constants,  etc. 

Each  export  potential  variable  in  a  system  has  an  associated 
potential  difference  equation  equating  to  zero  the  difference  between 
the  potential  of  the  node  to  which  the  variable  is  attached  and  the 
value  of  the  export  potential. 

An  interface  variable  (either  an  import  or  export  variable)  associated 
with  either  a  normal  or  information  node.  All  of  the  potential 
variables  attached  to  the  same  node  are  equal  to  the  potential  of  the 
node. 

A  modification  to  a  potential  difference  equation  corresponding  to 
the  insertion  of  a  series  resistance.  Used  to  prevent  singular 
systems. 

A  waveform  operator  for  removing  the  high  order  waveform  content 
of  its  argument  by  returning  a  waveform  which  is  the  convolution  of 
the  argument  with  a  square  pulse.  The  returned  waveform  is 
effectively  the  local  average  of  the  argument  waveform.  The 
smoothing  operator  removes  unnecessary  detail  from  a  waveform 
and  improves  the  representation  of  the  desired  properties  of  the 
waveform  with  fewer  coefficients. 

A  state  is  a  device  variable  whose  value  is  retained  between 
waveform  intervals.  Constants  of  integration  and  device  operating 
modes  are  the  most  common  uses  of  states. 
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Structural  Jacobian  A  code  indicating  the  nature  of  an  element  of  a  Jacobian  matrix: 

Code  0  Zero  Matrix 

I  Identity  Matrix 

D  Diagonal  Matrix 

L  Linear  Matrix 

A  Type  A  nonlinear  Matrix 

N  Nonlinear  Matrix 

U  Unknown 


Subsystem 


System 


System  Jacobian 


A  subset  of  the  devices  of  a  system  which  are  grouped  together  and 
solved  independently  of  other  devices  and  subsystems.  Subsystems 
have  not  been  implemented  in  WAVESEM. 

A  group  of  devices  and  subsystems  and  the  nodes  interconnected 
them. 

A  matrix  containing  the  partial  derivatives  of  the  system  equations 
with  respect  to  the  system  variables. 


System     Structural  A  matrix  describing  the  dependence  of  a  system's  equations  with 
Jacobian  Matrix  respect  to  the  system  variables.    The  dependence  is  specified  by  a 

matrix  whose  elements  are  a  code  indicating  if  the  dependence  is 

zero,  identity,  diagonal,  linear,  or  nonlinear. 


System  Variable 


Terminal 


Waveform 


Waveform  Content 


The  set  of  system  variables  is  composed  of  all  the  node  potentials 
and  all  the  device  import  flow  variables. 

A  modelling  analogy  to  a  physical  attachment  point  on  a  device. 
Normal  terminals  have  an  associated  flow  and  potential  variable  and 
are  used  to  model  the  transfer  of  energy  into  and  out  of  a  device. 
Information  terminals  have  only  a  potential  variable  and  are  used  to 
convey  information  between  devices. 

A  representation  of  a  variable  over  a  given  time  interval  consisting 
of  a  vector  of  coefficients  and  a  waveform  type  indicator  for 
specifying  how  the  coefficients  should  be  interpreted.  Common 
waveform  types  are  Legendre  Series,  Chebyshev  Series, 
Polynomials  and  Data  Points. 

The  magnitude  of  a  coefficient  of  a  waveform  divided  by  the  square 
root  of  the  sum  of  all  the  waveform  coefficients.  The  Waveform 
Contents  of  the  higher  order  coefficients  are  used  to  determine  if  the 
truncation  error  is  negligible. 
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Waveform  Type  An  indicator  specifying  how  the  coefficients  of  the  waveform  vector 

Indicator  should  be   interpreted.      Common  waveform  types  are   Legendre 

Series,  Chebyshev  Series,  Polynomials  and  Data  Points. 

WAVESIM  A   numerical    algorithm   development   program    incorporating   the 

systematic  treatment  of  waveforms  as  a  data  type,  the  terminal 
description  of  devices,  and  the  use  of  structural  Jacobians  in  system 
reduction. 
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Appendix  B:  Continuation  Parameter  Pitfalls 

If  used  properly,  continuation  parameters  can  help  enlargen  the  region  of  convergence 
of  an  iterative  scheme.  This  section  will  show  how  continuation  parameters  can  fail  due  to 
bifurcations  of  solutions. 

Take  for  example,  the  following  system  of  two  equations  and  two  unknowns 
F(x,y)  =  0: 

Fl(x,y)  =  y-(x3-x)  =  0 
F2(x,y)  =  y-(Mx+B)  =  0 

Initially,  set  M  =  0  and  B  =  1.875.  From  the  following  figure,  it  is  obvious  the  solution 
is  the  intersection  of  the  two  curves  and  falls  at  the  point  (1.5,1-875). 

Figure  B-l:  Solution  to  y  =  x3  -  x  and  y  =  1.875 
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~i ■ ■ — r- 


Nonllnear  Solution 


y  =  1 .875 


-5.0 


y  =  x*-x 


To  solve  this  system  with  a  continuation  parameter,  we  create  a  new  function  H(x,y,a) 
which  is  formed  by  combining  F(x,y)  with  a  linear  system  G(x,y): 

G1(x,y)  =  y-(mx+b)  =  0 
G2(x,y)  =  y-(Mx+B)  =  0 
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H(x,y,a)  =  aF(x,y)  +  (\-a)G(x,y)  =  0 

The  modeller  now  has  the  choice  of  selecting  m  and  b.  A  natural  choice  would  be  a 
linearization  about  a  given  point.  If  we  linearize  about  x  =  0,  the  values  are  m  =  -1  and  b  =  0. 
The  following  figure  shows  the  results  of  this  selection: 

Figure  B-2:  Continuation  Method  for  m=-l  b=0  Af=0  5=1.875 


ROOT  LOCUS  for  y  =  1.875    y  =  a{x*3  -x)  +  (a-l)(-x) 
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x  Root  Locus  Points 

y  =  a{xi-x)  +  (l-a)(-x) 
y  =  1.875 
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-1.9490 

0.0200 

7.8686 

-5.8222 

-2.0464 

0.0400 

5.7569 

-3.2569 

-2.5000 

0.0421 

5.6274 

-2.8637 

-2.7637 

0.0422 

5.6214 

-2.8107  -0.0613i 

-2.8107  +  0.0613i 

0.0600 

4.8125 

-2.4063  -  0.8387i 

-2.4063  +  0.8387i 

0.1000 

3.8553 

-1.9277-  1.0712i 

-1.9277+  1.0712i 

0.2000 

2.8743 

-1.4372 -1.0937i 

-1.4372+  1.0937i 

0.4000 

2.1609 

-1.0804-  l.OOlOi 

-1.0804+  l.OOlOi 

0.5000 

1.9746 

-0.9873  -  0.9614i 

-0.9873 +  0.9614i 

0.7000 

1.7263 

-0.8632 -0.898H 

-0.8632 +  0.898H 

1.0000 

1.5000 

-0.7500  -  0.8292i 

-0.7500  +  0.8292i 

Note  the  solution  for  a  =  0  is  (-1.875,1.875)  which  is  not  very  close  to  the  desired 
solution  for  a=  1.  Furthermore,  as  a  increases  slightly,  it  actually  becomes  slightly  more 
negative  until  the  nonlinear  curve  no  longer  intersects  the  linear  equation  in  the  left  hand 
plane.  At  this  point,  the  solution  has  a  discontinuity  and  jumps  into  the  right  hand  plane  with 
a  value  for  x  much  larger  than  the  solution.  The  root  locus  for  x  as  a  goes  from  0  to  1  clearly 
shows  this.  Hence  for  this  selection  of  m  and  b,  the  use  of  the  continuation  parameter  makes 
the  job  of  solving  the  system  tougher  instead  of  easier. 

If  we  choose  different  values  for  m  and  b,  the  situtation  may  change.  Say  for  example, 
we  set  m  =  1  and  b  =  0.  This  selection  appears  to  work  well  as  can  be  seen  with  the 
following  figure: 
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Figure  B-3:  Continuation  Method  for  m=l  6=0  A/=0  5=1.875 
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5 


-5 
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a=0 


a=.5 


y  =  1 .875 


ROOT  LOCUS  for  y  =  1.875    y  =  a<x"3-x)  +  (a- IX*) 
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a 

x  Root  Locus  Points 

y  =  cx(a'3-a-)  +  (1  -a)x 
j  =  1.875 

0 

1.8750 

0.0400 

1.7891 

-0.8945  -  5.0399i 

-0.8945  +  5.0399i 

0.2000 

1.6440 

-0.8220 -2.242H 

-0.8220  +  2.242H 

0.5000 

1.5536 

-0.7768 -1.3455i 

-0.7768  +  1.3455i 

1.0000 

1.5000 

-0.7500  -  0.8292i 

-0.7500  +  0.8292i 

The  solution  for  a  =  0  is  close  to  the  solution  and  as  a  increases,  it  rapidly  converges 
on  the  desired  solution  (1.5,1.875).  We  should  not  rejoice  however,  because  even  this 
selection  can  fail  for  other  choices  for  M  and  B.  For  example,  if  M  -  2.5  and  B  =  -3,  the 
following  figure  demonstrates  a  discontinuity  in  the  solution  path: 

Figure  B-4:  Continuation  Method  for  m=l  b=0  M-2.5  B--3 
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5 


y  =  2.5x  -  3 
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ROOT  LOCUS  for  y  =  2.5x-3    y  =  a(xA3-x)  +  (a-l)(x) 


-10  -8-6-4 
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a 

x  Root  Locus  Points 

y  =  a(x3  -  x)  +  (1  -  a)x 
y  =  2.5y-3 

0 

2.0000 

0.0100 

-13.2173 

11.1887 

2.0286 

0.0200 

-9.6223 

7.5604 

2.0619 

0.0400 

-7.0779 

4.9274 

2.1505 

0.0735 

-5.4659 

2.7706 

2.6953 

0.0736 

-5.4628 

2.7314 -0.0326i 

2.7314 +  0.0326i 

0.0800 

-5.2778 

2.6389 -0.376H 

2.6389 +  0.3761i 

0.1000 

-4.8192 

2.4096- 0.647  li 

2.4096  + 0.647  li 

0.3000 

-3.1844 

1.5922 -0.7780i 

1.5922 +  O.7780i 

0.5000 

-2.6891 

1.3445 -0.6507i 

1.3445 +0.6507i 

1.0000 

-2.2047 

1.1024  -0.3815i 

1.1024  +  0.38151 
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The  bottom  line  is  that  it  may  not  be  possible  to  develop  a  transformation  function 
whose  solution  vector  is  always  continuous.  Any  information  known  as  to  the  region  where 
the  probable  operating  point  lies  should  be  used  in  directing  the  solution  to  that  region.  For 
this  example,  if  x  is  known  to  be  constrained  to  the  interval  [-5  5]  and  M  is  known  to  be  less 
than  17.75  (.75»52  -  1  is  the  slope  of  the  line  tangent  \oy  -  x3  -  x  and  passing  through  (5,120) 
>  then  y  is  also  constrained  to  the  interval  [-120  120].  If  we  use  as  our  linearizing  function 
the  line  connecting  (-5,-120)  and  (5,120)  it  is  clear  the  root  locus  will  also  remain  within  the 
constraints  for  any  value  of  M  or  B  meeting  the  constraints  at  a  =  1 : 

y  =  alx*  - x)  +  (\  -  a)24x 
Figure  B-5:  Continuatin  method  for  m=24  b=0  M=2.5  B=-3 
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ROOT  LOCUS  for  y  =  2.5x-3    y  =  a(x*3-x)  +  (a- 1  >(24x) 


-10         -8-6-4-2  0 
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a 

x  Root  Locus  Points 

y  =  ot(x3  -x)  +  (1  -  a)24jc 
j  =  2.5j-3 

0 

0.0789  -13.7847i 

0.0789  +13.7847i 

-0.1395 

0.1000 

0.0789 -13.7847i 

0.0789 +13. 7847i 

-0.1579 

0.2000 

0.0909  -  9.0843i 

0.0909  +  9.0843i 

-0.1817 

0.3000 

0.1070 -6.8338i 

0.1070  +  6.8338i 

-0.2141 

0.4000 

0.1301  -5.3666i 

0.1301  +5.3666i 

-0.2603 

0.5000 

0.1657 -4.2523i 

0.1657 +  4.2523i 

-0.3313 

0.6000 

0.2265  -  3.3147i 

0.2265 +  3.3147i 

-0.4530 

0.7500 

0.4476  -  2.0659i 

0.4476  +  2.0659i 

-0.8952 

0.8500 

0.7291  -  1.3744i 

0.7291  +  1.3744i 

-1.4582 

0.9500 

0.9945  -  0.7737i 

0.9945  +  0.7737i 

-1.9890 

1.0000 

1.1024 -0.3815i 

1.1024 +  0.3815i 

-2.2047 
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For  this  example  it  is  actually  quit  easy  to  determine  if  a  bifurcation  will  occur.    At  a 
bifurcation,  the  x  root  locus  points  satisfy  the  following  relationship: 

(x-cf(x-d)  =  0 

x*  +  (-d  -  2c)x2  +  (c7  +  2cd)x  +  (-c2d) 

where  c  is  the  multiple  root  whose  paths  will  deviate  from  the  real  jr-axis  and  d  is  the 
root  staying  on  the  x-axis.  Now  the  actual  equation  defining  the  roots  is  given  by: 

ax3  +  ((l-a)m-a-M)x  +  (l-a)b  -B  =0 

Equating  terms  we  get: 

-d  -  2c  =  0 

i  1 

c+2cd  =-((!- a)m  -a-M) 
a 


-c d  =-((1-  a)b-B) 
a 


solving  this  system  for  c,  d,  and  a,  we  get: 

d=-2c 


c  = 


(l-a)b-B^ 
2a 


(1  -a)m  -a-M  +  3a 


f(l-a)b-B) 


V 


2a 


=  0 


If  one  of  the  solutions  for  a  is  a  real  number  in  the  interval  [0,1],  then  there  will  be  a 
bifurcation  and  possibly  a  discontinuity  in  the  path.  If  two  of  the  roots  approach  from  +«> 
and  -co  along  the  real  axis  and  a  solution  for  a  exists  in  the  interval  [0,1],  then  there  will 
definitely  be  a  discontinuity  in  the  solution  path.  If  two  roots  appraoch  from  off  the  real  axis, 
combine  at  the  bifurcation  point,  then  travel  in  the  +x  and  -x  directions,  there  will  be  three 
real  solutions  for  x  and  the  solution  path  will  converge  onto  one  of  them.  If  there  is  no  real 
solution  for  a  in  the  interval  [0,1],  then  there  will  be  no  bifurcation,  no  discontinuity  in  the 
solution  path  and  the  solution  will  be  unique. 
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Appendix  C:  Load  Flow  Example 


The  method  for  building  systems  can  be  applied  to  static  simulations  for  determining 
equilibrium  points  of  systems.  The  traditional  load  flow  is  representative  of  this  type  of 
problem.  Figure  C-l  shows  a  three  bus  load  flow  example  consisting  of  four  device  types: 
PV  Generator,  VD  Generator  (Slack  Bus),  PQ  Load,  and  a  transmission  line. 

Figure  C-l:  3  Bus  Load  Flow  Example 


^u 


Gl 


T12 
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C-l:  Device  Definitions 
C-l.l:  PV  Generator 


Interface  Variables 


Terminal                       Potential  Variable 

^low  Variable 

(KCL  Group)  Type 

VQ                                V  (export)                     Q  (import) 
DP                                D  (import)                    P  (export) 

(0)  Normal 
(0)  Normal 

The  import  Xmp  and  export  Xexp  vectors  are  defined  by: 

X,mp  — 

~Q~ 

D 

XCxp  = 

'V 
P 

Parameters 


Scheduled  Generator  Power 
Scheduled  Generator  Voltage 


Equations 


V  =  VG 
P  =  -P, 


Device  Structural  Jacobian 

The  device  structural  jacobian  is  given  by 

Jds  ~ 

"0 
0 

0" 
0 

Device  Jacobian 

The  device  jacobian  is  given  by: 

JD  = 

"0 
0 

0" 
0_ 
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C-1.2:  VD  Generator  (Slack  Bus) 
Interface  Variables 


Terminal                       Potential  Variable 

^low  Variable 

(KCL  Group)  Type 

VQ                                V  (export)                     Q  (import) 
DP                                D  (export)                     P  (import) 

(0)  Normal 
(0)  Normal 

The  import  X^  and  export  Xexp  vectors  are  defined  by: 

X,mp  = 

~Q~ 
p 

"^exp  = 

'V 
D 

Parameters 


D, 


Scheduled  Generator  Voltage 
Scheduled  Generator  Angle 


Equations 


V=V, 


D  =  DG 
Device  Structural  Jacobian 

The  device  structural  jacobian  is  given  by: 


J ds  ~ 


0     0' 
0     0 


Device  Jacobian 


The  device  jacobian  is  given  by: 


Jn  = 


0     0" 
0     0 
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C-1.3:  PQ  Load 
Interface  Variables 


Terminal                       Potential  Variable 

^low  Variable 

(KCL  Grou 

VQ                                V  (import)                     Q  (export) 
DP                                 D  (import)                     P  (export) 

(0)  Normal 
(0)  Normal 

The  import  X^  and  export  Xexp  vectors  are  defined  by: 

X.mp  = 

"V" 
D 

-^exp  = 

P 

Parameters 


Ql 

Equations 


Scheduled  Load  Real  Power 
Scheduled  Load  Reactive  Power 


P  =  P, 


Device  Structural  Jacobian 

The  device  structural  jacobian  is  given  by: 


Jds  — 

"0 
0 

0" 
0 

ice  Jacobian 

The  device  jacobian  is  given  by: 

Jd  = 

"0 
0 

0' 

()_ 
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C-1.4:  Transmission  Line 


Interface  Variables 


Terminal 

Potential  Variable 

Flow  Variable 

(KCL  Grou 

VQl 
DPI 

Vj  (import) 
Dj  (import) 

Qj  (export) 
Pj  (export) 

(0)  Normal 
(0)  Normal 

VQ2 
DP2 

V2  (import) 
D2  (import) 

Q2  (export) 
P2  (expon) 

(0)  Normal 
(0)  Normal 

The  import  X^  and  export  X     vectors  are  defined  by 


imp 


exp 


q: 

p. 


Parameters 


R 
X 


Transmission  Line  resistance 
Transmission  Line  reactance 


Equations 


Obtain  Y: 


R 


B 

R2+X2 
X 

R2+X2 

Y 
DY~- 

=  ^A2+B2 
=  atan2(B,A) 

-191 


Calculate  Side  one  current 

7u?  =  V1Ycos(D1  +  DY)  -  V2Y  cos(D2  +  DY) 
Iu  =  VXY  sin(Z>,  +  DY)  -  V2Y  sin(D2  +  DY) 


Calculate  Side  two  current 


Ay?  —    *\r 


*2J  -    *u 


Calculate  real  and  imaginary  parts  of  the  voltages 

VU(  =  Vlcos(Di) 
Vu  =  Vlsm(Dl) 

V1R  =  V2cos{D2) 
V21  =  V2sm{D2) 

Calculate  the  export  variables  (Powers) 


P^V^  +  VJu 


V-l  ~       VlR*U  "*"  *W\R 


*  2  ~  *2r'iR    ""  * 21*21 


x-2  —      ^2/r  2/  ~*~  ^  2J*2R 


Device  Structural  Jacobian 


~N 

N 

N 

N 

^DS  "" 

N 
N 

N 
N 

N 
N 

N 
N 

N 

N 

N 

N 
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Device  Jacobian 

Calculate  the  Partial  derivatives  of  the  voltages  with  respect  to  the  import  variables: 

9P* 


dXimp 


=  [cos(D,)      -V,sin(£>,)     0     0] 


_iL  =  [sin(I>1)     Vlcos(PJ    0    0] 

=  [0     0     cos(D2)      -V2sm(D2)] 


imp 

dXimp 


— -=[0     0     sin(Z)2)     KjCosCDj)] 


Calculate  the  partials  of  the  currents  with  respect  to  the  import  variables: 


3Ximp 


=  [Fcos(D,+Z)r)      -yV,sin(D,+Dy)      -Ycos(D2+DY)     YV2sin(D2+DY)] 


=  [Ysin(Dl+DY)     YV1cos(Di  +  DY)     -Ysm(D2  +  DT)     -YV2cos(D2+DY)] 


dXbnp 


^2*  <^LR 


<jXmp  OX,mp 


dly  dly 


dXunp  oXimp 
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Calculate  the  jacobian  matrix 


JD  = 


I* 
0 


it? 


V 


'\1 

0       0 

0       0 


LR 


V7 


\R 


0        0       0 
Vv         0        0       0 


0 
0 


-/. 


27 


'1R 


<2k 


'21 


V, 


v. 


2M 


0 

0 

-V. 


ik 


dX,mp 
dVv 

dxt 

dl 


imp 


\k 


dx 


mp 


dx 


imp 


dX,mp 

dx, 

dl 


ik 


imp 


ik 


dx 


mp 

dlv 


dX, 


imp 
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C-2:  Network  Description 

Figure  C-2-1  details  the  device  interconnections  of  the  3  Bus  system  shown  in  Figure 


C-l. 


Figure  C-2-1:  3  Bus  Loadflow  Block  Diagram 
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C-2.1:  Variable  Labeling  Convention 

For  this  example,  the  following  convention  will  be  used  for  labeling  variables  and 
functions: 

Device  Terminal  Variables:  jcm  bb  C)tf 

aa        Device  Name 
bb        Variable  Name 

c  n  =  normal  terminal 

i  =  information  terminal 

d  i=  import  variable 

e  =  export  variable 

/  p  =  potential  variable 

/=  flow  variable 

Device  import  variable  vector  jrMj 

aa        Device  name 

Device  export  variable  defining  function  xaabbc^  =  faubbc^xaaJ) 

aa        Device  Name 
bb        Variable  Name 

c  n-  normal  terminal 

i  =  information  terminal 

d  e  =  export  variable 

/  p  =  potential  variable 

/=  flow  variable 

Device  Jacobian  J^ 

Device  Jacobian  Element  Ja*j,b_sg 

aa        Device  Name 

bb        Export  Variable  Name 

gg        Import  Variable  Name 

System  Variables:  Node  Potentials  V„ 

n  Node  Serial  Number 

System  Variables:  Flow  Variables  1^  bb 

aa        Device  Name 
bb        Variable  Name 
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System  Equation:  KCL  gn() 

n  Serial  number  of  node  KCL  is  applied  to 

System  Equation:  Potentials  g„  m  w() 

n  Serial  number  of  node 

aa        Device  Name 

bb        Export  Potential  Variable  Name 

System  Jacobian  Element:  KCL  vs  Node  Potential  Jtyt _n  m 
System  Jacobian  Element:  KCL  vs  Import  Flow  Jsys _„ _„  bb 
System  Jacobian  Element:  Potential  Eqn  vs  Node  Potential  Jsys  cc  u  m 
System  Jacobian  Element:  Potential  Eqn  vs  Import  flow  Jsys  cc  ^  ^  bb 

n  Serial  number  of  KCL  node 

m  Serial  number  of  Node  Potential 

aa  Flow  Variable  Device  Name 

bb  Flow  Variable  Device  Variable  Name 

cc  Potential  Equation  Potential  Device  Name 

dd  Potential  Equation  Potential  Variable  Name 
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C-2.2:  Network  Specification 

Now  that  the  variable  labeling  convention  has  been  addressed,  it  is  time  to  define  the 
devices  and  the  network  interconnecting  them. 

PD  Generator  Gl 

Node 

1 
4 


Terminal 

Potential  Variable 

Flow  Variable 

VQ 
DP 

XGl_V_nep 
XGl_D_nep 

XGl_£_ntf 
XGlJP_nif 

Parameters 

Vg 

1.0  PU 

DG 

0.0  RAD 

Import  Vector: 

XGl_i  ~ 

XGl_Q_nif 
_XGl_P_nif_ 

= 

'gi_q 
Jgi_p_ 

PV  Generator  G2 


Terminal                Potential  Variable 

Flow  Variable 

»V                                          XG2  V  nep 

XG2_Q_nij 

U*                                           XG2_D_nip 

XG2_P_nef 

Parameters 

PG                0.5  PU 

VG                1.05  PU 

Import  Vector: 

XG2_i  ~ 

XG2_Q_mf 
_XG2_D_mp_ 

= 

*G2_Q 

.  v5 . 

Node 

2 
5 
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PQ  Load  L3 

Terminal 

VQ 
DP 

Parameters 


Potential  Variable 

XL3JV^nip 
XU_D_nip 


Flow  Variable 


lU_Q_nef 


XU_P_mf 


Ql 

Import  Vector: 


0.6  PU 
0.3  PU 


^u 


lU_V_nip 
'CU_D_rup 


v. 


Transmission  Line  T12 


Terminal 

Potential 

VQl 
DPI 

XTI2_VI_nip 
XT12_Dl_nip 

VQ2 
DP2 

XTl2_V2_nip 
XT12_D2_nip 

Parameters 

R 

0.15  PU 

X 

0.60  PU 

Import  Vector: 

T72 


Flow  Variable 

XT12_Ql_nef 
XT12_Pl_nef 

XT12_Q2_nef 
XT12_P2_nef 


X^nyijup 

XT12_Dl_n,p 
XT12_V2_nip 
XT12_D2_nip 


'v; 

= 

v2 

v5 

Node 

3 
6 


Node 

1 
4 

2 
5 
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Transmission  Line  T13 


Terminal 

Potential 

VQl 
DPI 

XT13_Vl_nip 
XT13_Dl_nip 

VQ2 
DP2 

XT13_V2_nip 
XT13_D2_nip 

Parameters 

R 

0.05  PU 

X 

0.20  PU 

Import  Vector: 

Flow  Variable 


*Tl3_Ql_nef 
XTl3J>l_ntf 

XT13_Q2_nef 
XTl3_P2_nef 


Node 

1 
4 

3 

6 


l77i 


Tiiyijup 

~v; 

T13_Dl_nip 

__ 

v4 

T13_V2_mp 

v3 

T13_D2_nip_ 

v6 

Transmission  Line  T23 


Terminal 

Potential 

VQl 
DPI 

XT23_Vl_nip 
XT23_DI_nip 

VQ2 
DP2 

XT23_V2_nip 
XT23_D2_nip 

Parameters 

R 

0.10  PU 

X 

0.40  PU 

Import  Vector: 

Flow  Variable 

XT23_Ql_nef 
XT23JPl_nef 

XT23_Q2_nef 
XT23J>2_ruf 


Node 

2 
5 

3 
6 


KT23 


T23_Vl_nip 

~v2- 

T23_Dl_rup 

__ 

Vs 

T23_V2_mp 

v, 

T23_D2_nip_ 

v6 
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C-2.3:  System  Variables  and  Equations 

There  are  nine  system  variable  and  equations  associated  with  this  example.  There 
are  the  six  node  potentials  plus  three  import  flow  variables  ordered  in  the  following 
manner: 

x^[Vx     V2    V,    V4     Vs    V6    IG1J2    IG]P    IG2J 

The  nine  system  equations  are  composed  of  six  Kirchhoff  Current  Law  equations  and 
three  potential  equations: 

8\\Xsys)  =  *G1_Q  ■*" XT12J)1 _nef~^ XT13 _Q1  _nef 

8l\Xsys)  ~*G2_Q  JtXT12_QZ_nef'>rXT23_Ql_nef 

83\Xsys)  =  XL3_Q_nef  "*"  XT13_Q2_nef  "*"  XT23_Q2_ruf 

8*\Xsys>  ~*G1J>  "*"  XT12_P1  _nef^  XT13_P1  _nef 

§5\XsysJ  =  XG2_P_nef  "*"  XT12_P2  _nef  "*"  XT23_P1  _nef 

86(Xsys)  ~  XL3_P_nef  +  XT13_P2_nef  "*"  XT23_P2_ruf 

8l_Gl_v(Xsys)  =   M  _  XGl_V_nep 

87_G2_V\Xsys)  ~*2~  XG2_V_nep 

8A_Gl_D\Xsys)  =   *4  ~  XG1  J)  _nep 
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C-2.4:  System  Structural  Jacobian  Matrix 

The  equations  for  generating  the  system  jacobian  matrix  are  given  by: 

gl(XVs) 


Jsys_\_l  -Jt12_Q1_V1  + '* T13 _Ql  VI  ~  "   +  " 


•*sys_l_2  =  JtJ2_Q1_V2  =  ™ 
^sysjji  =  JtJ3_Q1_V2  =  ** 
J  sys_\_A=''T12_Ql_Dl  ~*~Jt13_Q1_D1  =  "   +  ™ 
•*sys_l_5  ~  Jt12_Q1_D2  ~  ™ 
J*ys_\_6  =  Jt13_Q1_D2  =  ™ 


g2(xtys) 

•*sys_2_l  =  Jt12_Q2_V1  =  " 

J sys _2_2  ~  ^T12_Q2y2  "*" '•* T23 _Q1  _VJ  —  A'  +7V 

•'sysJ.J,  =  Jt23_Q1_V2  =  ** 


^sys_2_A  ~  Jt12_Q2_D1  ~  " 


Jsys_2_S  ~  Jt12_Q2_D2  "*" J  T23 _Q1  JD1  —N+N 


J sys_2J>  ~  ^T23_Q1J)2  ~  ™ 


J sys_2_G2_Q  ~  * 
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^sysJSJ  =  JT13J22V1  ~  " 
^ sys  J,  2  =  Jt23_Q2_V1  =  ™ 


-'sys_i_3  ~J  U_£>y  ~^~''T13J)2_\'2  "*""' T23_Q2_V2  ~  "  "*"^*   ~*~ ** 


/sjw_3_4  ~   *T13_Q2D1  ~  " 


^sys_3_S  ~  Jt23jQ2_D1  ~  " 


sysjij,  ~  J L3_Q_D  "*" ^T13_Q2_D2  "*" ^ T23_Q2_D2  —  "  +7V  +  N 


Jsys_A_\  =^T12_P]_V1  "*" 'J  T13_P1  _V1  ~  ™  +  " 

J  =  J  =N 

J sys  4_2     ^r;:  w  V2     iy 


^sysjiji  —  JT13_P1_V2  ~  ™ 


** sys _4_4  —Jt12J>1_D1  +  ^T13_P1_D1  ~  "   +™ 


°*sys_4_5  ~  ^T12_P1_D2  ~  ** 


T  =  T  =N 

J  sys_4J>       JT13_P1J)2       iV 


j  sys  4  Gl  P  —* 
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gsiXtys) 
''sys  5   1  =  Jt12  P2  VI  ~  " 


J  sys  5  2  —  ">T12  P2  V2  +  •* 


T23  PI   VI 


=  N+N 


/ryj_5_3  ~  -*T23J>1_V2  ~  " 


J  sys  5  4  —  Jt12  P2  Dl  ~  " 


''sys  5S~%'G2PD~*' J T12  P2  D2  "** J T23  PI  Dl  ~  "  """  ™  "*"  ™ 


"*  sys _5_6  ~  Jt23_P1_D2  ~  " 


J  sys  G2_Q  ~  J  G2  P_Q  ~  " 


ftfeJ 


•*  ra  6  1  -  Jm  P2  VI  ~  ™ 


JsysJ>_2  ~  ^T23_P2_V1  ~  " 


"*sys_6_i  ~  J  L3_P_V  "*"  J  J 1 3 _P2 _V2  "*"  J  T23 _P2 _V2  —  U  +/V  +/V 


J  sys  6  4       JT13  P2  Dl       ly 


^sys_6_5  ~  -*T23_P2_D1  ~  " 


"*  sys  66"  J  L3  P  D  '^''TIS  P2  D2  "*" J T23  P2  D2  ~  "  "*"  ^   ~*~  ** 
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Si  Gl   lAXtyt) 


"*sys_Gl_Vj  ~  * 


J 


sys_Gl_V_Gl_Q 


~     ''Gl   VO  ~  ^ 


J sys_Gl_V_Gl_P  ~     ^G1_VJ>  ~  " 


S2_G2_\\Xsyt) 


•*sys_G2_V_2  ~  ' 


''sys  G2  V  5~     Jg2   V  D  ~  " 


./ 


sys_G2_V_G2_Q  ~     Jg2_V_Q  ~  " 


&4  Gl  D\Xtys) 


J  sys_Gl_D_4  ~  * 


J  sys_Gl_D_Gl_Q  ~     J  G1_D_Q  ~  " 


J sys_Gl_D_Gl  P  ~     Ja  D  P  ~~  " 
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By  applying  the  rules  of  Structural  Jacobian  element  arithmetic  on  the  system 
equations,  we  can  generate  the  following  system  Structural  Jacobian: 

^N    N    N    N    N    N    I     0    0" 

NNNNNN00I 
NNNNNN000 
NNNNNN0I0 
NNNNNN000 
NNNNNN000 
7  00000000 
0/0000000 
000/00000 


Close  inspection  of  this  matrix  reveals  seven  blocks:  Six  lxl  element  blocks  and  one 
3x3  element  block: 


Block  1 


System  Row:  7 

System  Column:  1 

System  Variable:  Vj 
Equations: 

Structural  Jacobian: 


8\_G1   V\Xsys)  ~  *\      XG1  V 


_nep 


hi  =  in 
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Block  2 


System  Row:  8 

System  Columns:  2 

System  Variable:  V2 
Equations: 

Structural  Jacobian: 


System  Row:  9 

System  Column:  4 

System  Variable:  V4 
Equations: 

Structural  Jacobian: 


82  G2  V\Xsvs)  ~  *2       XG2  V 


sys/  2.  uZ_V  __nep 


JB2  =  U] 

Block  3 


Si  Gl  d(Xsvs)  ~  *4       XG1  D 


_nep 


JB3  =  [/] 
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System  Rows: 
System  Columns: 
System  Variables: 
Equations: 


Structural  Jacobian: 


Block  4 

3        5        6 
3        5        6 

y3    v5    v6 

83\Xsys)  =  XL3_Q_nef  +  XTl3_Q2_nef  +  XT23  _Q2_r*f 
§5\Xsys)  =  XC2_P_mf  "*"  XTJ2_P2_nef  ~*~  XT2i_Pl_nef 
86\Xsys)  =  XL3_P_nef  "*"  XT13_P2_nef  "*"  XT23_P2_mf 


J  B4  ~ 


N 

N 

N~ 

N 

N 

N 

N 

N 

N_ 

Block  5 


System  Row:  1 

System  Column:  7 

System  Variable:  Igi_q 
Equations: 

Structural  Jacobian: 


8l\Xsys)  ~  *G1_Q  +  XT12_Ql_nef  +  XT13_Ql_ruf 


JB5  =  U] 
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Block  6 

System  Row:  2 

System  Column:  8 

System  Variable:         IGI  P 


Equations: 


Structural  Jacobian: 


82(XsyJ  ~  *G2_Q  "*"  XTI2 _Q2 _nef~^ '  XT23 _Q1  _nef 

he  =  [/] 
Block  7 


System  Row:  4 

System  Column:  9 

System  Variable:  Ig2_q 
Equations: 

Si\Xsys)  =  'd_P  +  XT12_Pl_nef  +  XT13_PI_nef 

Structural  Jacobian: 

JB7  =  U] 
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C-2.5:  Solving  the  System 

Applying  the  equations  for  the  first  three  blocks  yields: 

rr0i\ 


M  ~  JGl_V_nep 
^2  =  fG2y_nep\ 


vlOj; 


1.0     PU 


rp\ 


lwj; 


(V(\l 


v<=fG1D 


ru-p 


vJ_uJ 


=  1.05     PU 


=  0.0     PU 


Now  the  following  system  of  three  equations  for  the  fourth  block  must  be  solved: 


Where: 


gs(XB4>Xp,e) 
&6\XB4iXpre) 


V, 


=  0 


v5 


~v; 

pre 

v2 

vA 

Starting  with  the  intial  guess  of  [1  0  0]T  for  xM  we  obtain  the  following  error  vector 
and  jacobian  matrix: 


0 
X          = 

error 

"  0.1824  " 
-0.4485 
0.5706  _ 

J°  = 

JB4 

'  6.9412 
-0.6176 
1.7253 

0.6176 

4.1176 

-  2.4706 

-1.7941 

-  2.4706 

7.1765 
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Inverting  the  Jacobian  and  multiplying  by  the  error  vector  results  in  the  following 


correction  vector  for  x 


B4 


0.0441 

-0.0769 

0.0424 


XB4  ~  XB4       XA 


By  repeating  the  Newton-Raphson  iterations  several  more  times,  the  following  table 
can  be  constructed: 


Iteration 

v3 

Vs 

v6 

fcO 

gsQ 

geO 

0 

1.0000 

0.0000 

0.0000 

0.1824 

-0.4485 

0.5706 

1 

0.9559 

0.0769 

-0.0424 

0.0289 

-0.0084 

0.0311 

2 

0.9502 

0.0762 

-0.0463 

2.284e-4 

-0.448e-4 

2.208e-4 

3 

0.9502 

0.0761 

-0.0464 

1.370e-8 

-0.214e-8 

1.240e-8 

From  these  results,  the  final  three  blocks  can  easily  be  solved: 

*G1_Q  =     JT12_Ql_n€J\XT12_,)  ~  JT13 _Q1  _nej\XT13j) 


IG1M  =  -0.1451  PU 


'd_P  -     hl2_Pl_nef^XT12j)       JTli _PI _nej\XT13_i) 

IG1P  =  -0.1233  PU 

*G2_Q  ~     JT12_Q2_nej\XT12jl)  ~  JT2B_Q1  _nef\XT23_i) 


IG2_q  =  -0.2483  PU 
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C-3:  Summary  of  Results 

Busl 


Bus  Voltage  Magnitude 

1.0  PU 

Bus  Voltage  Angle 

0.0  rad 

Gl  Real/Reactive  Power 

-0.1233  PU 

-0.1451  PU 

T12  Real/Reactive  Power 

-0.1437  PU 

-0.0423  PU 

T13  Real/Reactive  Power 

0.2671  PU 
Bus  2 

0.1874  PU 

Bus  Voltage  Magnitude 

1.0500  PU 

Bus  Voltage  Angle 

0.0761  rad 

G2  Real/Reactive  Power 

-0.5  PU 

-0.2483  PU 

T12  Real/Reactive  Power 

0.1471  PU 

0.0558  PU 

T23  Real/Reactive  Power 

0.3529  PU 
Bus  3 

0.1925  PU 

Bus  Voltage  Magnitude 

0.9502  PU 

Bus  Voltage  Angle 

-0.0464  rad 

L3  Real/Reactive  Power 

0.6000  PU 

0.3000  PU 

T13  Real/Reactive  Power 

-0.2617  PU 

-0.1661  PU 

T23  Real/Reactive  Power 

-0.3383  PU 

-0.1339  PU 
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Appendix  D:  Modified  Load  Flow  Example 

Appendix  C  demonstrated  how  a  system  can  be  built  and  solved  for  a  conventional 
load  flow  problem.  This  example  demonstrates  how  control  signals  such  as  real  and  reactive 
power  sharing  signals  can  be  incorporated  in  the  load  flow  solution.  In  particular,  this 
example  connects  two  parallel  generators  to  a  load  via  a  transmission  line.  A  conventional 
load  flow  fails  for  this  example  because  the  generator  bus  voltage  magnitude  is 
overdetermined  and  there  is  no  relationship  for  sharing  reactive  power.  In  this  example, 
information  variables  are  used  to  force  each  generator  to  be  proportionally  loaded  and  have 
the  same  power  angle. 

Figure  D-l:  Parallel  Generator  Load  Flow  Example 


r\> 


Gl 


r\> 


G2 


T12 


D-l:  Device  Definitions 


In  addition  to  the  transmission  line  and  PQ  load  defined  in  Appendix  C,  two  more 
devices  must  be  defined:  A  slack  bus  generator  incorporating  the  load  sharing  information, 
and  a  PQ  generator  employing  the  load  sharing. 
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D-l.l:  VDS  Generator  (Slack  Bus) 
Interface  Variables 


Terminal                       Potential  Variable 

Flow  Variable 

( 

<CL 

,  Grou] 

VQ                                V  (export) 
DP                                D  (export) 
p                                   p  (export) 
q                                   q  (export) 

Q  (import) 
P  (import) 

(0)  Normal 
(0)  Normal 
Information 
Information 

The  import  x^  and  export  xexp  vectors  are  defined  by: 

*imp  ~ 

P 

■*exp  ~ 

'V 

D 

P 
A. 

Parameters 


D, 


Scheduled  Generator  Voltage 
Scheduled  Generator  Angle 
Scheduled  Generator  Power  Base 


Equations 


V  =  Vr 


D  =Dr 


P  = 


Pb 


q  = 


Device  Structural  Jacobian 

The  device  structural  jacobian  is  given  by: 


->ds  ~ 


"0 

0" 

0 

0 

0 

L 

_N 

N_ 
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Device  Jacobian 

The  device  jacobian  is  given  by: 


Jn  = 


"0 

0    " 

0 

0 

0 

1 

Pb 

1 
p 

Q 

P2 
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D-1.2:  PQS  Generator 

Interface  Varia 

ibles 

Terminal 

Potential  Variable 

Flow  Variable 

(KCL  Grou] 

VQ 
DP 

P 

q 

V  (import) 
D  (import) 
p  (import) 
q  (import) 

Q  (export) 
P  (export) 

(0)  Normal 
(0)  Normal 
Information 
Information 

The  import  x^  and  export  xexp  vectors  are  defined  by: 

V 

D 

P 

q. 


imp 


Parameters 


PB  Scheduled  Generator  Power  Base 


Equations 


P=~PbP 


x-p  = 


Q 

p 


Q=-pbp<i 
Device  Structural  Jacobian 

The  device  structural  jacobian  is  given  by: 


^DS  ~ 

"0     0    N 
0     0     L 

N 
0 

Device  Jacobian 

The  device  jacobian  is  given  by: 

./, 


0     0     -PBq      -PBp- 


0     0       -/> 


0 
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D-2:  Network  Description 

Figure  D-2-1  is  a  block  diagram  of  the  system  represented  in  Figure  D-l: 
Figure  D-2-1:  Parallel  Generator  Example  Block  Diagram 


D-2.1:  Network  Specification 

Using  the  same  variable  labeling  convention  as  in  Appendix  C,  the  devices  and 
network  are  specified  by: 

VDS  Generator  Gl 

Node 

1 
3 
5 

6 


Terminal                Potential  Variable 

Flow  Variable 

*V                                          XGl_V_nep 

XGl_Q_nif 

U*                                           XGl_D_nep 

XGl_P_nif 

P                                                XGl_p_Up 

Q                                                XGl_q_iep 

Parameters: 

VG                1.05  PU 

DG                0.00  rad 

PB                 1.00  PU 

Import  Vector: 

XGl_i  ~ 

XGl_Q_mf 
_XGJ_P_nif_ 

= 

*G1_Q 

Jgi_p_ 
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PQS  Generator  G2 


Terminal 


Potential  Variable 


Flow  Variable 


Node 


VQ 
DP 

P 

q 

Parameters: 


■*-G2_V_nip 
XG2_D_nip 
XG2_p_Up 
XG2jqJip 


XGlJZ_nef 
XGl_P_nef 


0.50  PU 


Import  Vector: 


XG2  i  ~ 


XG2_V_nip 

~v; 

XG2_D_mp 

v3 

XG2_p_iip 

Vs 

_  XG2_qJip  _ 

v6 

Transmission  Line  T12 


Terminal 

Potential 

VQl 
DPI 
VQ2 
DP2 

XT12_Vl_nip 
XT12_Dl_nip 
XT12\2_nip 
XTl2_D2_nip 

Parameters: 

R 

0.05  PU 

X 

0.20  PU 

Import  Vector: 

Flow  Variable 

XTl2_Ql_nef 
XT12_Pl_nef 
XT12_Q2_nef 
XT12_P2_nef 


Node 

1 
3 

2 
4 


l772 


XTI2_Vl_nip 

~v; 

XT12_Dl_nip 

v3 

XT12_V2_nip 

v2 

XT12_D2_nip_ 

A 
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PQ  Load  L3 

Terminal 

Potential  Variable 

Flow  Variable 

VQ 
DP 

XUVjnip 
XU_D_nip 

XUJ>_nef 
XL3_P_nef 

Parameters: 

Pl 
Ql 


0.60  PU 
0.10  PU 


Import  Vector: 


Node 

2 
4 


XL3  i  ~" 


VL.?  V 


nip 


JKU_D_n,p 


v4 
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D-2.2:  System  Variables  and  Equations 

There  are  eight  system  variables  and  equations  associated  with  this  example.   There 
are  the  six  node  potentials  plus  two  import  flow  variables  ordered  in  the  following  manner: 

x„  =  tYi     V2     v3     v*     Vs     V*    la*     Igi  J 


The  eight  system  equations  are  composed  of  four  Kirchhoff  Current  Law  equations 
and  four  potential  equations: 

8\\Xsys)  =  *G1J2  ^  XG2_Q_nef"^  XTJ2_Q1  _nef 

8r<Xsys)  ~  XL3_Q_nef  +  XT12_Q2_nef 
8l(Xsys)  =  *G1J>  +  XG2_P_nef  +  XT12_Pljxef 
Si^sys)  =  XL3_P_nef~*~XT12_P2_nef 
8\_Gl_V\Xsys)  ~   M  ~XGl_V_nep 
8-}_Gl_D\Xsys)  =   *3  ~  XG1  _D _nep 
8s_Gl_p\Xsys)  =  V5  ~  XGl_p_iep 
86_Gl_q\Xsys>  =   * 6~XGl_q_iep 
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D-2.3:  System  Structural  Jacobian  Matrix 

Using  the  device  structural  jacobian  matrices  along  with  the  system  equations,  the 
following  system  structural  jacobian  can  be  created: 

N     N     N     N     N     N     I      0 
NNNN0000 


Jss  ~ 


N 

N 

w 

N 

L 

0 

0 

/ 

N 

N 

N 

N 

0 

0 

0 

0 

I 

0 

0 

0 

0 

0 

0 

0 

0 

0 

/ 

0 

0 

0 

0 

0 

0 

0 

0 

0 

/ 

0 

0 

L 

0 

f) 

0 

0 

0 

/ 

N 

N 

Applying  the  system  reduction  algorithms,  five  blocks  can  be  identified:  two  lxl 
element  blocks  and  three  2x2  element  blocks: 


System  Row:  5 

System  Column:  1 

System  Variable:  V2 
Equation: 


Structural  Jacobian: 


Block  1 


S\_Gl_V\Xsys)  ~   M       XG]_V_nep 


JBJ  =  [/] 
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Block  2 


System  Row: 
System  Column: 
System  Variable: 
Equation: 


Structural  Jacobian: 


6 
3 


#3  Gl  D\Xsys)  ~  ^3       XG1  D 


ru-p 


hi  =  EH 

Block  3 

System  Rows: 

2 

4 

System  Columns: 

2 

4 

System  Variables: 

v2 

v4 

Equations: 

Structural  Jacobian: 


£2V*ryJ  —  XU_Q_nef~^XTJ2_Q2_nef 
Si\Xsys)  ~  XU_P_nef  +  XT12_P2_nef 


JB3  ~ 


N     N 
N     N 
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System  Rows: 
System  Columns: 
System  Variables: 
Equations: 


Structural  Jacobian: 


System  Rows: 
System  Columns: 
System  Variables: 
Equations: 


Structural  Jacobian: 


Block  4 


lGl  P 


8l\Xsys)  ~  *G1_P  +  XG2_P_nef  +  XT12_Pl_nef 
8s_G]_p\Xsys)  =  ^5~XGl_p_,ep 


J  B4  ~ 


L     I 
I     L 


Block  5 


1        8 
6        7 


lGl_Q 


§i\Xsys)  "~  *G1_Q  ~*~XG2_Q_ruf~*'XT12J)l_nef 
&6_G1  _q\Xsys)  =   *6~XGl_qJep 


JB5  ~" 


N     I 

I     N 
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D-2.4:  Solving  the  System 


Applying  the  equations  for  the  first  two  blocks  yields: 


*1  -JGiy_nep 
M  ~  JG1  _D_nep 


=  1.05     PU 


VL 


0 


=  0.0     rad 


The  remaining  blocks  are  systems  of  2x2  equations  and  unknowns.  Blocks  3  and  5 
are  nonlinear  and  must  be  solved  iteratively.  Block  4  is  linear  block  requiring  only  one 
iteration: 

Block  3: 


n 

v2 

v4 

feO 

fcO 

0 

1.0000 

0.0000 

-0.1353 

0.5414 

1 

1.0000 

-0.1095 

0.0293 

0.0085 

2 

0.9933 

-0.1105 

2.017e^ 

0.841e-4 

3 

0.9933 

-0.1105 

1.046e-8 

0.569e-8 

Block  4: 

n 

V5 

'gi_p 

fcO 

gcij) 

0 

1.0000 

1.0000 

1.1188 

2.0000 

1 

0.4125 

-0.4125 

0.0000 

0.0000 

Block  5: 

n 

y6 

*G1_£ 

giQ 

^Gl_q() 

0 

0.0000 

0.0000 

0.1750 

0.0000 

1 

0.2828 

-0.1167 

0.000e-8 

-0.000e-8 
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D-3:  Summary  of  Results 


Busl 


Bus  Voltage  Magnitude 

1.05  PU 

Bus  Voltage  Angle 

0.00  rad 

Gl  Real/Reactive  Power 

-0.4125  PU 

-0.1167  PU 

G2  Real/Reactive  Power 

-0.2063  PU 

-0.0583  PU 

T12  Real/Reactive  Power 

0.6188  PU 
Bus  2 

0.1750  PU 

Bus  Voltage  Magnitude 

0.9933  PU 

Bus  Voltage  Angle 

-0.1 105  rad 

L3  Real/Reactive  Power 

0.6000  PU 

0.1000  PU 

T12  Real/Reactive  Power 

-0.6000  PU 

-0.1000  PU 

Information  Node  5 

(P) 

Magnitude 

0.4125 

Information  Node  6 

(q) 

Magnitude 

0.2828 
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Appendix  E:  Waveform  Examples 
E-l  Examples  of  Waveform  Types 

While  the  possibilities  of  waveform  definitions  is  endless,  this  thesis  will  concentrate 
on  the  following  waveform  types: 


Waveform  Type 

Code 

Undefined 

0 

Data  Series 

1 

Fourier  Series 

2 

Legendre  Series 

3 

Polynomials 

4 

Matlab  Polynomials 

5 

Chebyshev  Series 

6 

The  code  in  the  above  table  refers  to  the  value  of  the  type  element  in  the  waveform 
structure. 

E-l.l  Data  Series 

A  data  series  consists  of  n  equally  spaced  samples  of  the  waveform  stored  in  an  array 
of  double  precision  floating  point  numbers.  The  first  coefficient  is  associated  with  the 
value  of  the  waveform  at  the  beginning  of  the  time  interval  and  the  last  coefficient  is 
associated  with  the  value  of  the  waveform  at  the  end  of  the  time  interval.  Each  element  of 
the  array  is  given  by: 

n  —  1 


i  =  1,2, ...,« 

A  data  series  representation  is  primarily  used  for  plotting  the  time  history  of 
variables  and  for  calculating  waveform  operators  which  would  prove  difficult  with  other 
waveform  types. 
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E-1.2  Polynomial  Expansion 

A  polynomial  expansion  consists  of  n  coefficients  of  a  polynomial  representation  of 
the  waveform  normalized  over  the  interval  [-1  1]. 

n 

f(x)  =  I  c,x'~' 
<  =  1 

x  =  -l+2 

Polynomial  expansions  are  useful   for  evaluating   switching  operators  described 
above. 

A  Matlab  Polynomial  expansion  is  expressed  in  descending  order: 


I  =  i 


E-1.3  Orthogonal  Function  Series 

Orthogonal  Function  Series  can  be  an  excellent  means  for  representing  waveforms. 
In  an  orthogonal  series  representation,  the  value  of  the  coefficient  of  a  given  order  of  the 
characteristic  function  is  independent  of  the  number  of  terms  in  the  orthogonal  series.  This 
means  truncating  an  orthogonal  series  by  eliminating  higher  order  coefficients  will  still 
result  in  the  best  possible  fit  with  the  remaining  coefficients. 

In  general,  an  orthogonal  series  representation  is  of  the  form: 

f(x)=tc,F,_1(x) 
i  =  i 

x  €  [.r0     A',] 

where  F,{x)  is  the  ;'th  order  characteristic  function  of  the  orthogonal  function  series 
with  respect  to  the  weighting  function  r{x).  These  characteristic  functions  observe  the 
following  property: 
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jr(x)Fm(x)Fn(x)dx  =  0     for     m*n 

x\ 
jr(x)Fm(x)FJx)dx=G(m) 

With  this  property,  the  coefficients  c,  of  the  series  can  be  found: 

*i 
r-^—jr(x)f(x)Fl_l(x)dx 


G(i-l) 

x0 


E-l.3.1  Fourier  Series 


Perhaps  the  most  widely  used  orthogonal  function  series  is  the  Fourier  Series. 
Unfortunately,  the  Fourier  Series  is  unsuitable  for  dynamic  simulations.  To  see  why,  one 
need  only  look  at  the  manner  in  which  a  function  is  expressed  in  a  Fourier  Series: 

n  n 

f(x)  =  A0+  X  A, cos(/7U')  +  £  B,  sin(/7u) 
;=i  /=i 


x  =  -1  +  2 


t-tQ 


Notice  that  at  x  =  1  and  x  =  -1  sin(j'Ttx)  =  0  and  cos(/7ur)  =  (-1)'  .  Consequently 
f(l)  =  f(-l).  In  other  words,  the  starting  value  and  ending  value  of  any  waveform 
represented  by  a  fourier  series  is  forced  to  be  identical.  In  dynamic  simulations  however, 
we  often  have  equations  of  the  form: 

This  equation  is  normally  evaluated  by  integration: 

y  =y0+  j  fyrfdi 

'o 
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where  y0  is  the  value  of  the  waveform  y  at  the  beginning  of  the  interval.  If  y  is 
represented  by  a  Fourier  Series,  then  y  evaluated  at  the  end  of  the  interval  will  also  be  y0. 
In  other  words,  while  the  value  of  a  state  variable  may  change  within  the  interior  of  a 
time  interval,  at  the  boundaries,  the  value  is  constrained  to  be  a  constant  independent  of 
the  length  of  the  time  interval.  This  constraint  is  artificial  and  not  a  property  of  real 
physical  systems. 

E-l.3.2  Legendre  Series 

Legendre  Series  use  legendre  polynomials  to  form  the  basis  of  an  orthogonal 
function  series  over  the  interval  [-1  1].  Legendre  polynomials  L^x)  of  order  i  are  defined 
by  the  following  equations: 

U;(X) 

L-(x)  = for     i     even 

v,(a) 

L;(*)  =  -77T    for    *    odd 

v,(l) 

t  s     i     /(/  +  1)   2,i(i-2)(i  +  1)(/  +  3)   4    i(i -2)  (i -4)  (i  +  l)  (i+3)  (i +5)   6 
",(*)=! ^-x  + x x  +... 

(i-l) (i+2)   3i(i-l)(i-3)(i  +  2)(i+4)   5 
v,(*)  =  x 3j x  + x  - 

(i-l)(i-3)(i-5)(i+2)(i+4)(i+6)   7 

x  +... 

7! 

The  first  six  Legendre  polynomials  are  readily  found  to  be: 

L0(a)=1 

Lx(x)=x 
L2{x)  =  \0x2-\) 


1 


3 


L3(x)  =  -(5x-3x) 
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L4(x)  =  -(35;c4-3(b:2  +  3) 

o 


L5(A)  =  i(63A-5-70x3  +  15A) 

o 

Legendre  Series  also  obey  the  following  recursion  formula 
(n  +  \)Ln  +  l(x)  =  {In  +  1  )xL„(x)  -nLn_x{x) 

An  nth  order  legendre  series  representation  of  a  waveform  is  given  by: 


m=lciLi_i(x) 

/  =  i 


where: 


*0  = 

-1 

*i  = 

1 

r(x) 

=  1 

",(A)  = 

L,{x) 

2 

w     2/  + 1 

The  time  interval  [t0 12]  can  be  mapped  to  the  interval  [-1  1]  with  the  following 
transformation: 

x=-\+2 

h-k 

The  coefficients  c,  can  be  found  by  integration: 


2/-1  ' 
-i 


jmL^^dx 


E-l.3.3  Chebyshev  Series 

Chebyshev  Series  use  Chebyshev  polynomials  to  form  the  basis  of  an  orthogonal 
function  series  over  the  interval  [-1  1].  Chebyshev  polynomials  T;(x)  of  order  i  ait, 
defined  by  the  following  equations: 
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T,(x)  =  x 
T1+1(x)  =  2xTi(x)-Ti_l(x)     for     i  >  1 
The  following  three  Chebyshev  polynomials  are  given  by: 

T2(x)  =  2x2-l 

T,(x)  =  4xi-3x 

T4(x)  =  Sx4  -Sx2+l 
An  nth  order  Chebyshev  Series  representation  of  a  waveform  is  given  by: 


f(x)=lc,Ti_i(x) 
j  =  i 


where 


x0  =  -1 


the  weighting  function  r(x)  is  given  by: 

1 


r(x)  = 


vr: 


.2 


and: 


Fi(x)  =  Tl(x) 


G(0)  =  k 


G(m)  =  -     for     m>0 

2 
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E-2  Waveform  Conversions 


This  section  describes  how  to  convert  a  waveform  consisting  of  a  vector  of 
coefficients  of  order  n1  to  a  waveform  of  possibly  a  different  type  composed  of  a  vector  of 
coefficients  of  another  order  n2.  In  all  cases,  the  conversion  is  a  linear  matrix  operator. 
Hence  for  given  values  of  w,  and  n2,  the  conversion  matrix  need  only  be  calculated  once. 

From  here  on,  L,(x)  refers  to  a  vector  containing  the  polynomial  coefficients  of  the  ith 
order  Legendre  Polynomial.  Lj^xj)  refers  to  the  ith  order  Legendre  Polynomial  evaluated  at 
Xj.  Likewise,  T({x)  refers  to  a  vector  containing  the  polynomial  coefficients  of  the  ith  order 
Chebyshev  Polynomial.  T£xj)  refers  to  the  ith  order  Chebyshev  Polynomial  evaluated  at  xy 

E-2.1  Legendre  Series 

E-2.1.1  Legendre  Series  to  Data  Series 

Converting  a  Legendre  Series  of  order  nt  to  a  data  series  of  order  n2  requires  the 
construction  of  the  following  matrix: 


Ald  — 


^iW 

L&o) 

••         4,,-i(*o) 

LM 

L2{xx) 

-       Kx-M 

£l(*2> 

L2(^) 

■       LAx,) 

Ll(*„,-l)   Ll(^-l) 


^,.1(^-1) 


JC,=-l+2- 


iu  —  1 


If  C,  is  the  vector  of  the  Legendre  Series  coefficients  and  Cd  is  the  vector  of  data 
series  points,  the  following  relation  holds: 

E-2.1.2  Legendre  Series  to  Legendre  Series 

Converting  a  Legendre  Series  of  order  «;  to  order  n2  requires  only  the  truncation  of 
terms  if  n7  >  n2  or  the  insertion  of  zeros  in  the  higher  order  terms  if  n1  <  n2. 
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E-2.1.3  Legendre  Series  to  Chebyshev  Series 

Converting  a  Legendre  Series  of  order  nl  to  a  Chebyshev  Series  of  order  n2  fust 
requires  the  truncation  or  padding  with  zeros  of  the  Legendre  series  to  order  n2.  The 
resulting  Legendre  Series  should  then  be  multiplied  by  the  following  upper  trianglular 
matrix: 

Ajj-  —  AT  AL 

AL  =  [L0{x)    Lx{x)    L2(x)     ...     L^.fc)] 

AT  =  [T0(x)     T^x)     T2(x)     ...     T^x)] 

where  Lt(x)  is  a  vector  of  order  n2  holding  the  polynomial  coefficients  of  the  ;'th  order 
Legendre  Polynomial  and  T,^x)  is  a  vector  of  order  n2  holding  the  polynomial  coefficients 
of  the  /th  order  Chebyshev  Polynomial. 

E-2.1.4  Legendre  Series  to  Polynomial  Expansion 

Converting  a  Legendre  Series  of  order  n1  to  a  polynomial  expansion  of  order  n2  first 
requires  the  truncation  or  padding  with  zeros  of  the  Legendre  series  to  order  n2.  The 
resulting  Legendre  Series  vector  should  then  be  multiplied  by  the  following  upper 
triangular  matrix: 

AL  =  [L0(x)     Lx{x)     L2(x)     ...     L^_x{x)] 

where  L,{x)  is  a  vector  of  order  n2  holding  the  polynomial  coefficients  of  the  /th  order 
Legendre  Polynomial. 
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E-2.2  Chebyshev  Series 
E-2.2.1  Chebyshev  Series  to  Data  Series 

Converting  a  Chebyshev  Series  of  order  n2  to  a  data  series  of  order  n2  requires  the 
construction  of  the  following  matrix: 


ATD  - 


1 

Ux0) 

T2(x0) 

1 

TM 

T&J 

1 

Ux2) 

T2(x2) 

1     Uxn.)     r2(*     ,) 


",-1 


n.-lV-^-l 


(*o) 


Mt) 


Tn%_,(x.x) 


x=-l+2- 


n2-l 


If  C,  is  the  vector  of  the  Chebyshev  Series  coefficients  and  Cd  is  the  vector  of  data 
series  points,  the  following  relation  holds: 

E-2.2.2  Chebyshev  Series  to  Legendre  Series 

Converting  a  Chebyshev  Series  of  order  nt  to  a  Legendre  Series  of  order  n2  first 
requires  the  truncation  or  padding  with  zeros  of  the  Chebyshev  series  to  order  n2.  The 
resulting  Chebyshev  Series  should  then  be  multiplied  by  the  following  upper  trianglular 
matrix: 

ALT  =  AL  AT 

AL  =  [L0(x)     Lx(x)     L2(x)     ...     L^^ix)] 

AT  =  \T0(x)     Tx(x)     T2(x)     ...     T^ix)] 

where  L,(x)  is  a  vector  of  order  n2  holding  the  polynomial  coefficients  of  the  ith  order 
Legendre  Polynomial  and  T,{x)  is  a  vector  of  order  n2  holding  the  polynomial  coefficients 
of  the  /th  order  Chebyshev  Polynomial. 
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E-2.2.3  Chebyshev  Series  to  Chebyshev  Series 

Converting  a  Chebyshev  Series  of  order  nt  to  order  n2  requires  only  the  truncation 
of  terms  if  n1  >  n2  or  the  insertion  of  zeros  in  the  higher  order  terms  if  nt  <  n2. 

E-2.2.4  Chebyshev  Series  to  Polynomial  Expansion 

Converting  a  Chebyshev  Series  of  order  n1  to  a  polynomial  expansion  of  order  n2 
first  requires  the  truncation  or  padding  with  zeros  of  the  Chebyshev  series  to  order  n2. 
The  resulting  Chebyshev  Series  vector  should  then  be  multiplied  by  the  following  upper 
triangular  matrix: 

AT  =  [Ux)     Tx(x)     T2{x)     ...     r^_,(jc)] 

where  T{(x)  is  a  vector  of  order  n2  holding  the  polynomial  coefficients  of  the  z'th  order 
Chebyshev  Polynomial. 
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E-2.3  Polynomial  Expansion 
E-2.3.1  Polynomial  Expansion  to  Data  Series 

Converting  a  polynomial  expansion  of  order  n,  to  a  data  series  of  order  n2  requires 
the  construction  of  the  following  matrix: 


™pd  - 


1 


■h 


x-i 


ru  —  1 


n. 

-r 

*0 

n. 

-i 

*1 

n 

-l 

x2 

n. 

-l 

"2 

-l 

x  =-1+2- 


n-y  -  1 


If  Cp  is  the  vector  of  the  polynomial  coefficients  and  Cd  is  the  vector  of  data  series 
points,  the  following  relation  holds: 

^d  =APDCp 

E-2.3.2  Polynomial  Expansion  to  Legendre  Series 

Converting  a  polynomial  expansion  of  order  n,  to  a  Legendre  Series  of  order  n2 
requires  first  converting  to  a  Legendre  series  of  order  n1  then  converting  the  Legendre 
Series  to  order  n2.  Recall  that  the  matrix  for  converting  from  a  Legendre  Series  to  a 
Polynomial  is  upper  triangular.  Hence  one  only  needs  to  use  backward  substitution  to 
solve  for  the  Legendre  Series  coefficients: 


AL  =  [Lo(x)     Ly(x)     L2(x) 


C=ALC, 


,(*)] 


E-2.3.3  Polynomial  Expansion  to  Chebyshev  Series 

Converting  a  polynomial  expansion  of  order  «;  to  a  Chebyshev  Series  of  order  n2 
requires  first  converting  to  a  Chebyshev  series  of  order  nt  then  converting  the  Chebyshev 
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Series  to  order  n2.  Recall  that  the  matrix  for  converting  from  a  Chebyshev  Series  to  a 
Polynomial  is  upper  triangular.  Hence  one  only  needs  to  use  backward  substitution  to 
solve  for  the  Chebyshev  Series  coefficients: 

AT  =  [Ux)     r.(A-)     T2(x)     ...     T^x)] 

Cp  -  ATC, 

E-2.3.4  Polynomial  Expansion  to  Polynomial  Expansion 

Converting  a  polynomial  expansion  to  another  polynomial  expansion  of  higher 
order  only  requires  setting  the  higher  order  terms  to  zero.  Converting  to  a  lower  number 
of  terms  requires  more  effort.  The  best  method  is  to  convert  to  an  orthogonal  function 
series,  truncate,  and  convert  back.  Since  all  of  these  operations  are  linear  matrix 
operations,  the  conversion  matrix  need  only  be  calculated  once.  For  this  conversion, 
either  the  Legendre  Series  or  the  Chebyshev  series  would  be  appropriate  since  the  type 
conversions  to  and  from  the  series  solution  does  not  add  any  truncation  error  (The 
truncation  error  is  solely  due  to  the  truncation  of  the  Legendre  Series  or  Chebyshev  series 
and  not  due  to  the  conversions). 
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E-2.4  Data  Series 
E-2.4.1  Data  Series  to  Data  Series 

There  are  many  methods  for  converting  a  data  series  to  another  data  series  with  a 
different  number  of  coefficients.  Two  common  interpolation  schemes  for  performing  this 
conversion  are  linear  interpolation  and  cubic  splines.  These  methods  can  be  found  in 
many  numerical  methods  textbooks  and  will  not  be  described  here. 

E-2.4.2  Data  Series  to  Legendre  Series 

If  ftj  >  n2,  a  Data  Series  can  be  converted  to  a  Legendre  Series  by  taking  the 
pseudo-inverse  of  the  matrix  converting  a  Legendre  Series  to  a  Data  Series.  If  nt  <  n2,  the 
Data  Series  can  be  converted  in  a  similar  manner  to  a  Legendre  Series  of  order  n2  padded 
with  zeros  to  order  w,. 


A,  n  — 


*LD 


1 

^iW 

L2(x0) 

1 

LM 

L2{xx) 

1 

LM 

Z-2(*2) 

s-1 


'"J-> 


(xj 


1     Lr(xn,)    L2(xn.)     ...     L„x(xn.) 


x  =  -l+2- 


«,-l 


If  Cd  is  the  vector  of  data  series  points  and  C,  is  the  vector  of  Legendre  Series 
Coefficients,  the  following  relation  holds: 

E-2.4.3  Data  Series  to  Chebyshev  Series 

Converting  a  Data  Series  to  a  Chebyshev  Series  can  be  done  in  the  same  manner  as 
the  conversion  to  a  Legendre  Series: 
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ATD  — 


1 

TM 

T2(x0) 

•       T^-Mo) 

1 

W 

T2{xx)       . 

•     t^m 

1 

Ux2) 

T2(x2) 

■       T-M 

i    r^.,)   r^.,) 


n,-l 


(**,-,) 


x=-l+2- 


»i-l 


If  Cd  is  the  vector  of  data  series  points  and  Cc  is  the  vector  of  Chebyshev  Series 
Coefficients,  the  following  relation  holds: 


^d  ~  "■TD^-c 


Cc  —  (ATDAID)   ATDCd 


E-2.4.4  Data  Series  to  Polynomial  Expansion 

Converting  a  data  series  to  a  polynomial  expansion  of  equal  or  less  order  using  a 
least  squares  fit  is  a  straight  forward  process.  If  the  number  of  points  in  the  data  series  nt 
is  equal  to  or  less  than  the  number  of  points  in  the  polynomial  n2,  the  resulting 
polynomial  will  pass  through  each  point  of  the  data  series.  If  larger,  the  polynomial  will 
not  necessarily  pass  through  all  of  the  data  series  points,  but  will  be  a  least  square 
approximation. 

For  rij  <  n2: 

For  this  case,  the  problem  is  to  solve  for  the  coefficients  of  the  polynomial  cpi  for 
i  <  nv  For  the  higher  coefficients  (i  >  «7),  cpi  =  0.  In  the  following  discussion,  let  Cd  be 
the  vector  of  nl  data  series  coefficients  and  Cp  be  the  vector  containing  the  first  «, 
polynomial  coefficients.  Define  the  «;  x  n}  matrix  A  as  follows: 
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Apd  - 


v1l-l 


n 

-1" 

*o 

n 

-1 

*i 

n 

-1 

X2 

n 

-1 

"l 

-] 

- 

x  =  -l+2- 


ii,-! 


Matrix  APD  is  square,  clearly  has  rank  «7,  and  therefore  is  invertible.  Consequently 
solving  for  Cp  is  straight  forward: 

(-p  ~  ApD^-d 

For  n1  >  n2: 

If  the  number  of  data  points  is  greater  than  the  number  of  polynomials,  the  number 
of  columns  in  the  APD  matrix  described  above  would  have  n2  columns  and  nt  rows.  APD 
would  clearly  not  be  invertible.  The  pseudo-inverse  of  APD  can  be  calculated  and 
provides  the  least  squares  fit  of  the  data  series: 

^  p  —  \ApDAPD)   APDLd 
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E-3  Waveform  Arithmetic 

This  section  describes  how  to  perform  addition,  subtraction,  multiplication,   and 
division  on  the  various  types  of  waveforms. 

E-3.1  Data  Series 

Performing  waveform  arithmetic  on  data  series  is  very  easy.  The  waveforms  are 
converted  to  the  proper  size  and  then  added,  subtracted,  multiplied  or  divided  element  by 
element. 

E-3.2  Polynomials 

E-3.2.1  Addition/Subtraction 

Adding  or  subtracting  two  polynomial  waveforms  simply  entails  converting  the  two 
waveforms  to  the  proper  length  and  adding  or  subtracting  element  by  element. 

E-3.2.2  Multiplication 

Multiplying  polynomial  waveform  W  of  size  nw  and  Y  of  size  ny  together  to  get 
polynomial  Z  of  size  nw  +  ny  -  1  can  be  accomplished  by  constructing  the  following 
matrix  of  size  nw  +  ny-  Ix  nw: 


Ti 

0 

0 

0      ... 

0 

0 

Y2 

Yt 

0 

0     ... 

0 

0 

Yi 

Y2 

Yr 

0     ... 

0 

0 

Y, 

Y3 

Y2 

r,    ... 

0 

0 

Mp  = 

■ 

• 

• 

0 

0 

0 

0      ... 

\ 

yv 

0 

0 

0 

z  = 

0      ... 
•  MpW 

0 

r- 

Z  can  now  be  truncated  or  padded  with  zeros  to  convert  it  to  the  proper  length.  The 
truncation  of  a  polynomial  is  discussed  in  section  E-2.3.4. 
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E-3.2.3  Division 

Dividing  two  polynomial  expansions  can  be  difficult,  particularly  if  the 
denominator  polynomial  has  one  or  more  zero  crossings.  In  general,  there  is  no  simple 
method  for  performing  the  division,  although  the  recursion  process  described  in  this 
section  will  work.  Define  the  problem  to  be: 

"» 

IB/"1 

There  are  two  parts  to  the  problem.  The  first  task  is  to  use  synthetic  division  until 
the  numerator  of  the  remainder  is  of  size  nc  -1  or  less.  The  second  task  is  to  convert  the 
remaining  fraction  into  another  polynomial  expansion  by  a  process  similar  to  synthetic 
division,  but  proceeding  from  the  constant  term  and  working  up  in  order. 

Synthetic  division  is  the  process  of  dividing  one  polynomial  by  another  until  the 
remainder  is  of  order  1  less  than  the  denominator. 


ld,xl- 

1  =  1 

d               ^  rlx 

_      »4      nd-ne         /  =  , 

—          X               \ 

C                         "' 

k  =  l 

r,  =  d, c, 

4, 

Initially,  dt  is  set  equal  to  bt.  After  the  first  iteration,  d(  is  set  equal  to  the  remainder 
r,.  The  process  is  repeated  until  nd  =  nc  -  1.  At  this  point,  the  direction  of  the  division  is 
reversed  and  we  get: 


"i 


«,-i 


I4*'-1      A  I  r,x' 

/  =  i  "i        /  =  i 


=  —  +  x 
c. 


S  CtX*     '  X  CtX* 
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In  this  manner,  we  can  express  the  remaining  fraction  as  another  polynomial 
expansion.  The  actual  values  for  F,  are  equal  to  the  sum  of  the  components  from  the 
forward  and  backwards  synthetic  division. 

Note  that  if  the  denominator  has  a  zero  over  the  interval  [-1,1],  the  backwards 
synthetic  division  will  result  in  a  diverging  series. 
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E-3.3  Legend  re  Series 

E-3.3.1  Addition/Subtraction 

Adding  or  subtracting  two  Legendre  Series  waveforms  simply  entails  converting  the 
two  waveforms  to  the  proper  length  and  adding  or  subtracting  element  by  element. 

E-3.3.2  Multiplication 

Multiplying  two  Legendre  Series  together  can  be  accomplished  in  two  ways.  The 
first  way  is  to  convert  the  Legendre  Series  to  polynomial  expansions,  multiply  the  two 
together,  then  convert  the  product  to  the  Legendre  Series  of  the  proper  size.  The  second 
method  uses  the  recursion  formula  for  the  Legendre  series  to  assist  in  the  process: 

To  multiply  Legendre  Series  Y  of  size  ny  by  the  Legendre  Series  W  of  size  nw  to 
obtain  the  Legendre  Series  Z  of  size  nz  =  ny  +  nw  -  1,  Y  must  first  be  converted  to  a 
polynomial  expansion  Yp  of  size  ny: 

AL  =  [L0(x)     L,(.r)     L2{x)     ...     L^_,(a)] 

YP=ALY 
The  recursion  fonnula  for  the  Legendre  Series  is  given  by: 


( 


ft  +  l 


*A(*)=    rr-r  K<;.,W+    ^~—   L;  +  1(x) 


2/  +  1 


2i  +  lJ 


which  can  be  translated  into  the  following  matrix  for  multiplying  a  given  Legendre 
Series  of  size  nz  by  x: 
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Axl  - 


0 

3 

0 

0     ... 

0 

0 

1 

0 

2 
5 

0     ... 

0 

0 

0 

2 
3 

0 

3 

7     "" 

0 

0 

0 

0 

3 

0     ... 

0 

0 

n,-2 


0     0 

0 

0     .. 

'      2{nz  -  2)  +  1 

0 

0     0 

0 

0     .. 

0 

n:-\ 

2{nt-\)  +  \ 

0     0 

0 

0     .. 

n2-\ 

0 

•      2{nz-2)  +  \ 

If  we  define  the  vector  Ypl  to  be  Yp  padded  with  zeros  such  that  it  is  of  size  nz,  we 
can  define  the  following  nz  x  nw  matrix: 


A-mpl  - 


Ypl       ^XLXpl       ^XL^XL^pl 


a";~xy_] 


\XL       M  pi 

The  final  nz  x  nw  multiplication  matrix  Amll  can  now  be  found: 

Amu  —  AmplAL 

Z=AmllW 

Of  course  Z  may  have  to  be  truncated  or  padded  with  zeros  to  convert  it  to  the 
desired  length. 

E-3.3.3  Division 

There  is  no  straight  forward  method  for  dividing  two  legendre  series.  The  easiest 
way  appears  to  be  converting  to  polynomial  expansions,  performing  the  divison,  then 
converting  back  to  the  legendre  series. 
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E-3.4  Chebyshev  Series 
E-3.4.1  Addition/Subtraction 

Adding  or  subtracting  two  Chebyshev  Series  waveforms  simply  entails  converting 
the  two  waveforms  to  the  proper  length  and  adding  or  subtracting  element  by  element. 

E-3.4.2  Multiplication 

Multiplying  two  Chebyshev  Series  together  can  be  accomplished  in  two  ways.  The 
first  way  is  to  convert  the  Chebyshev  Series  to  polynomial  expansions,  multiply  the  two 
together,  then  convert  the  product  to  the  Chebyshev  Series  of  the  proper  size.  The  second 
and  preferred  method  uses  an  alternate  definition  of  a  Chebyshev  Polynomial  to  assist  in 
the  process: 

Tnix)  =  cos(n  cos-1  (a)) 
T^(x)  =  Tn(x) 

From  this  definition,  the  product  of  two  Chebyshev  Polynomials  can  easily  be 
derived: 

Tn{x)Tm{x)  =  cos(n  cos-1(A'))cos(m  cos-1(a)) 
Tn(x)Tm(x)  =  -(cos((n  +m)cos~\x))  +  cos((n -m)cos~\x))) 

Ux)Tm(x)  =  ^(Tn+m(x)  +  Tn_m(x)) 

To  multiply  Chebyshev  Series  Y  of  size  ny  by  the  Chebyshev  Series  W  of  size  nw  to 
obtain  the  Chebyshev  Series  Z  of  size  nz  =  ny  +  nw-  1,  three  nz  x  nw  matrices  should  first 
be  constructed: 
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Y  = 


Am,i  - 


r,  o  o 
y2  y,  o 
y3    y2    y, 


0      0      0 
0      0      0 


0 

0    " 

0 

0 

0 

0 

\ 

v> 

0 

\. 

Am,2  — 


Y  Y  Y 

1  1  *2  J 3 

r2  r,  r4 

n  n  ^5 


"0 

0 

0 

0 

0 

>', 

y2 

n 

0 

0 

F, 

y2 

mfi  = 

0 

0 

0 

r, 

The  final  «z  x  nw  multiplication  matrix  A^  is  given  by: 

Amn  —  'zK"-mii  +Amt2  +Amt3) 


Z=AmnW 

mtt 
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Of  course  Z  may  have  to  be  truncated  or  padded  with  zeros  to  convert  it  to  the 
desired  length. 

E-3.4.3  Division 

There  is  no  straight  forward  method  for  dividing  two  chebyshev  series.  The  easiest 
way  appears  to  be  converting  to  polynomial  expansions,  performing  the  divison,  then 
converting  back  to  the  chebyshev  series. 
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E-4  Waveform  Functions 

E-4.1  Data  Series 

E-4.1.1  Trigonometric  and  Exponential  Functions 

All  trigonometric  and  exponential  functions  can  be  performed  point  by  point  on  the 
data  series  coefficients. 

E-4.1.2  Integration  and  Differentiation 

There  are  a  number  of  techniques  for  integrating  or  differentiating  Data  Series.  All 
are  by  their  nature  approximations  and  can  suffer  from  numerical  instability  problems 
associated  with  conventional  simulations.  One  simple  method  of  integration  employs  the 
trapezoidal  rule: 


$dd  - 


0 

0 

0 

0 

0 

h 

h 

0 

0 

0 

2 

2 

h 

h 

h 

0 

0 

2 

2 

h 

h 

h 

h 

0 

2 

2 

h 

h 

h 

h 

h 

2 

2 

h 

2 
h 
2 
h 
2 


h  h  h  h 
h  h  h  h 
h     h      h      h 


0 

0 

0" 

0 

0 

0 

0 

0 

0 

0 

0 

0 

0 

0 

0 

h 

• 

0 

0 

2 

h 

h 

2 

0 
h 

h 

h 

2_ 

h  = 


n-\ 


With  this  matrix,  the  integral  equation: 
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Y  =  Y0  + 


Wdx 


Becomes  the  matrix  operation: 


T  =  -l 


Y  =  SDDW  +  Y0 


The  vector  Y  may  be  now  converted  to  a  different  length  if  so  desired. 

Differentiating  a  Data  series  can  be  done  in  a  number  of  ways.  The  secant  method 
can  be  easily  implemented  with  the  following  matrix: 


"■DDl  ~ 


1 

1 

0 

0 

0 

1 

1 

0 

0 

0 

2 

1 

2 

1 

0 

0 

~2 

1 

2 

1 

0 

~2 

0 

2 

0 

0 

0 

0 

0 

0 

0 

0 

0 

0 

0 

0 

0 

0 

0 

0     0.. 

2 

0 

2 

0 

0 

0 
h  - 

0     0.. 

1 

.       0 

-1 

1 

Another  approach  is  to  choose  a  differentiation  matrix  such  that  it  is  consistent  with 
the  integration  matrix.  Consistency  is  defined  by  the  following  matrix  equation: 


^DD^DD2  ~  ™* 


where 
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M  = 


0  0  0  0 
-110  0 
-10  10 
-10     0     1 


The  M  matrix  reflects  the  fact  that  differentiating  a  data  series  will  destroy  the 
subsequent  constant  of  integration.  Since  SDD  is  generally  singular,  only  its 
pseudo-inverse  can  be  taken: 

^DD2  ~  WDD^DD/     ^DD"* 


This  matrix  actually  has  a  very  simple  construction: 


i-'rim  — 


'DD 


du 


2/7-3 
n 

dn 

_3 
n 
3 

n 


In -5       2«-7 


n 
In -5 


n 


'33 


n 

2/7-7 
n 

2/7-7 


n 

du 

_1_ 
n 


In -9 

n 
In -9 

n 
In -9 

n 
In -9 
n 

d55 


dxx  is  equal  to  the  the  negative  sum  of  all  the  other  terms  in  the  xth  row.    As  a 
consequence,  all  of  the  row  sums  of  DDD2  are  equal  to  zero  and  DDD2  is  singular. 

E-4.1.3  Switching  Functions 

All  switching  functions  can  be  performed  point  by  point  on  the  data  series 
coefficients. 
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E-4.1.4  Waveform  Smoothing 


There  are  times  when  it  may  be  desirable  to  remove  high  spectral  content  features 
of  a  waveform.  One  way  to  do  this  is  to  replace  the  value  at  each  point  in  the  time 
domain  by  the  average  of  the  waveform  over  some  interval  [x  -  A,x  +  A].  This  can  be 
accomplished  by  defining  the  following: 

f 


nA  =  int] 


A(k-1) 


where  int(x)  is  the  integer  nearest  x. 


Asmth  — 


1 

1 

1 

«A 

«A 

"a 

1 

1 

1 

1 


Ha  +  2 


_1_ 

2nA 

0 


«A+1      nA+l 


"a+1 


1 


1 


nA  +  2 


nA  +  2 


1 

0 

n± 

1 

1 

nA+l 


] 


«A+1 


1 


nA  +  2     n,  +  2 


nA  +  2 


1 

1 

1 

1 

1 

2nA 

2nA 

2nA 

2nA 

2nA 

1 

1 

1 

1 

1 

2nA 

2nA 

2nA 

2nA 

2nA 

Multiplying  a  data  series  by  Asmth  will  return  a  smoothed  version  of  the  data  series. 
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E-4.2  Polynomial  Expansion 
E-4.2.1  Trigonometric  and  Exponential  Functions 

There  is  often  no  direct  way  of  evaluating  a  trigonometric  or  expontential  function 
of  a  polynomial  expansion.  Instead,  the  function  is  performed  on  a  data  series  converted 
from  the  argument  polynomial.  The  resulting  polynomial  is  then  reconverted  back  into  a 
polynomial. 

E-4.2.2  Integration  and  Differentiation 

Integrating  a  polynomial  Y  of  size  ny  results  in  another  polynomial  Z  of  size 
nz  =  ny  +  1.  The  nz  x  ny  integration  matrix  SDP  is  given  by: 


$DP  — 


-1 

1 

1 

1 

2 

~3 

4 

1 

0 

0 

0 

0 

1 

2 

0 

0 

0 

0 

1 
3 

0 

0 

0 

0 

1 

4 

(-1)"'" 

ny-  1 
0 

0 
0 
0 


(-1) 


0 
0 

0 

0 


0      0       0       0 
0      0       0       0 


ny-l 


The  integral  is  evaluated  by: 


^  —  ^dp^  "*"  A> 


Of  course,  Z  may  be  converted  to  a  polynomial  of  a  different  size  if  desired. 

Differentiating  a  polynomial  Y  of  size  ny  results  in  another  polynomial  Z  of  size 
«z  =  ny- 1.  The  nz  x  ny  differentiation  matrix  ADP  is  given  by: 


-253 


A-dp  - 


0  10  0 
0  0  2  0 
0     0     0     3 


0  0 

0  0 

0  0 


0     0     0     0 
0     0     0     0 


n,-2 


0 
n-l 


The  Differential  is  evaluated  by: 


^  —  ™DpY 


E-4.2.3  Switching  Functions 

Switching  functions  are  those  which  produce  a  Polynomial  waveform  Y  which  is 
composed  of  m  pieces  of  other  Polynomial  waveforms.  Let  fi  be  the  Polynmomial 
representation  of  the  /th  piece  of  Y.  Let  x0(f)  be  the  x  coordinate  of  the  ending  point  of 
the/th  piece  where  x0(0)  =  -1  and  x0(m)  =  1. 

Define  Y(  to  be  the  Legendre  Series  representation  of  Y  : 


y,= 


Then  using  the  orthogonality  property  of  the  Legendre  Series: 


x0(j) 


■*o0'-D 


2i-l) 

— —  fficMx}dx 

2     j> 


Now  define  the  following  row  vector: 

/«/))  =  V-MJ))    I'M'))    LMJ)) 


Ln.MJ))    Ln(x0U))] 
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With  SDL  as  defined  in  section  E-4.3.2  and  Amp^)  as  defined  in  section  E-3.3.2  the 
solution  for  Y,  can  easily  be  found: 

1 


G,= 


2 

0 

0     ... 

0 

0 

3 
2 

0     ... 

0 

0 

0 

5 

2     '" 

0 

0     0     0 


2/7-1 


Now  we  need  only  convert  F,  to  a  polynomial  exansion  Y: 

Y=AJ, 

where 

AL  =  [L0(x)    Lx(x)     L2(x)     ...     Ln_,(A)] 

E-4.2.4  Waveform  Smoothing 

There  are  times  when  it  may  be  desirable  to  remove  high  spectral  content  features 
of  a  waveform.  One  way  to  do  this  is  to  replace  the  value  at  each  point  in  the  time 
domain  by  the  average  of  the  waveform  over  some  interval  [x  -  A,x  +  A].  This  can  be 
expressed  by  the  following  integral: 


i  =  i  2A  J    j  =  \ 

x  -A 


The  only  problem  with  the  above  equation  is  near  the  boundaries  x  =  -1  and  x  =  1 
where  the  integration  interval  has  the  possibility  of  crossing  the  boundaries  and  including 
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within  the  average  a  section  of  the  polynomial  outside  the  defining  interval  [-1,1].  Hence 
the  smoothed  polynomial  should  be  composed  of  the  following  three  segments  (assuming 
A<1): 

-1  <a<-1+A 

x+A 

17/'  = ]-—  f  tw/j^dx 

,Tl      "'  X+A+l     J      ;  =  1         J 

-1 

-1+A<a<1-A 

*+A 


,  =  1  2A    J     ;  =  1 

j:  -A 


1-A<*<1 


1-1  l-Jt+AJ      ;  =  1         ' 

i  -A 


Note,  if  1  <  A  <  2  then  the  interval  boundaries  are  given  by: 

[-1     ,      1-A] 

[1-A     ,     -1+A] 

[-1+A     ,      1] 

If  A  >  2  then  there  is  only  one  interval  and  the  average  of  the  waveform  is  returned: 


\)iw; 


yi  =  -  |         r:X'-ldx 


Y,  =  0     for    /  >  1 

For  A  <  2  evaluating  the  integrals  require  the  definition  of  shifting  a  waveform  left 
or  right  by  A.  This  can  be  done  by  constructing  the  following  binonomial  matrix: 
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*e*P  = 


11111 

0  12     3     4 

0  0     13     6 

0  0     0     14 

0  0     0     0     1 


This  matrix  can  be  generated  by  the  following  recursion  formula: 

B«p(i.y)=i 

Bexp(2:n,l)  =  0 
Bexp(i,j)=Bcxp(i,j-l)  +  Bcxp(i-\,j-l) 

Multiplying  Bexp  element  by  element  by  the  following  matrix  £A  will  give  us  the 
transformation  matrix  Bshfi  for  shifting  a  waveform  left  by  A. 


BA  = 


1     A     A" 


A4 


0  1  A  A2  A3 

0  0  1  A  A2 

0  0  0  1  A 

0  0  0  0  1 


,  =  i  j-\ 

M=BshfiN 

The  tools  are  now  all  present.  W  can  be  integrated  using  the  integration  matrix  SDP 
defined  in  section  E-4.2.2.  The  limits  of  integration  for  the  three  segments  can  be  applied 
by  either  using  Bshfi  for  the  limits  involving  x,  or  by  direct  evaluation  for  those  limits  not 
involving  x.     Dividing  by  the  averaging  interval  comes  next.     For  the  first  and  third 
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intervals,  the  methods  outlined  in  section  E-3.2.3  can  be  used  to  divide  a  polynomial  by 
another  polynomial.  Finally,  the  procedure  for  generating  Switching  Functions  described 
in  section  E-4.2.3  can  be  used  to  generate  the  coefficients  for  the  solution  Y. 
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E-4.3  Legendre  Series 
E-4.3.1  Trigonometric  and  Exponential  Functions 

There  is  often  no  direct  way  of  evaluating  a  trigonometric  or  expontential  function 
of  a  Legendre  Series.  Instead,  the  function  is  performed  on  a  data  series  converted  from 
the  argument  Legendre  Series.  The  resulting  polynomial  is  then  reconverted  back  into  a 
Legendre  Series. 

E-4.3.2  Integration  and  Differentiation 

Differentiating  a  Legendre  Series  can  be  done  easily  by  differentiating  the  recursion 
formula  for  the  Legendre  Series.  Recall: 

(i  +  l)L,  +  1)(x)  =  (2/  +  l)xL:(x)  -  iL(i_l}(x) 


Differentiating: 


dLi+l(x)(2i  +  l 

dx       ~{  i  +  l 


dL,{x) 
dx 


+W-    7 


i  +  l 


dL-,_x{x) 


dx 


where: 


dL0(x) 
dx 


=  0 


dLx{x) 
dx 


=  l=L0(x) 


The  goal  is  to  generate  the  following  nx  n  matrix: 
dL0(x)     dLx(x)     dL2(x) 


*DL 


dx 


dx 


dx 


dLn_x{x) 
dx 


The  columns  of  ADL  can  be  solved  recursively  once  we  define  the  matrix  A^  for 
multiplying  a  Legendre  Series  Vector  by  x. 


xL,(x)  = 


<      i 


KV  +  1J 


Li_l(x)  + 


'i  +  l  ^ 


2/+1 


L.U*) 
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A>XL  ~ 


0 


1 


3 
1     0 

0     0 


0     0 

2 


0 


°^ 


0 
0 

0 
0 


0  0  0  0 
0  0  0  0 
0     0     0     0 


n-2 


2(n-2)  +  l 

0 

n-l 
2{n  -  2)  +  1 


0 
n-l 


2(«-l)+l 

0 


Note  that  the  last  row  of  A^  has  been  elminated  to  make  the  matrix  square.  This 
will  not  cause  any  problems  since  in  the  recursion  formula,  the  last  coefficient  of  the 
vector  multiplying  AXL  is  always  zero. 

Let  ADL(:J)  represent  the/th  column  of  ADL.  Let  /  be  the  n  x  n  identity  matrix.  The 
recursion  formula  states: 


ADL(:,i+2)  = 


f2/+n 


j  +  1 


OV4D,0>>  +!)+/(:.  i  +  D)- 
1  <  i  <  n  -  2 


<    i    ^ 


i  +  l 


^pl(:'  0 


Once  A0/_  is  constmcted,  it  can  be  used  to  calculate  derivatives.  Let  W  and  Y  be 
vectors  of  Legendre  Series  coefficients  of  size  n.  Then  the  following  statements  are 
identical: 

y  =  dW 
dx 

Y  =  ADLW 

Of  course,  the  wth  coefficient  of  Y  will  always  be  zero  since  the  wth  row  (as  well  as 
the  first  column)  of  ADL  will  always  be  populated  with  zeros. 
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Integration  is  a  bit  more  complex.  In  general,  the  problem  is  to  solve  the  following 
equation: 


Y  =  Y0  +       Wdx 

First,  the  w+1  x  n  indefinite  integral  matrix  SlL  should  be  found.  The  easiest  way  of 
generating  SIL  begins  by  adding  an  additional  column  to  ADL  using  the  same  recursion 
formula  to  form  the  n  x  n+1  matrix  ADU.  S/L  is  simply  the  pseudo-inverse  of  ADL1: 

Sil  =  \AduAdu)  ADU 

The  next  step  is  to  evaluate  the  integral  at  x  =  -1.  This  can  be  done  by  multplying 
the  following  row  vector  by  SlL: 

X_,  =  [l      -1     1      -1     ...     (-I)""1] 

The  first  row  of  StL  contains  all  zeros.  If  this  row  is  replaced  by  -S.,  and  the 
resulting  matrix  called  SDL,  we  have  all  the  pieces  for  calculating  the  integral  of  a 
Legendre  Series: 

Y  =  SDLW  +  Y0 

Of  course,  the  vector  Y  may  have  to  be  truncated  or  padded  with  zeros  as  required. 

E-4.3.3  Switching  Functions 

Switching  functions  are  those  which  produce  a  Legendre  Series  waveform  Y  which 
is  composed  of  m  pieces  of  other  Legendre  Series  waveforms.  Let  /J  be  the  legendre 
series  representation  of  the  /th  piece  of  Y.  Let  x0(j)  be  the  x  coordinate  of  the  ending 
point  of  the/th  piece  where  x0(0)  =  -1  and  x0(m)  =  1. 

Let: 
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K, 


Y  = 


Then  using  the  orthogonality  property  of  the  Legendre  Series: 


*00')   , 
*b(/-i)v 


2/-1 


f^L^dx 


Now  define  the  following  row  vector: 

/UoO'))  =  &>«/))     *iW/))     IaW/))     •••     A,-iC*b(/))     A.W/))] 

With  S^  as  defined  in  section  E-4.3.2  and  Am,X)  as  defined  in  section  E-3.3.2  the 
solution  for  Y  can  easily  be  found: 

1 


G,= 


2     ° 

0     ... 

0 

o    1 

0     ... 

0 

0     0 

5 

2     '" 

0 

0     0     0 


2/2-1 


T7I 

rr  =  I  (/(*0(/))  -  /(*o(/  - D))WU(/;)G, 

E-4.3.4  Waveform  Smoothing 

There  is  no  obvious  method  for  performing  waveform  smoothing  in  the  Legendre 
Series  spectral  domain.  Instead,  the  waveform  should  be  converted  to  a  polynomial 
expansion  and  the  methods  of  section  E-4.2.4  employed. 
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E-4.4  Chebyshev  Series 
E-4.4.1  Trigonometric  and  Exponential  Functions 

There  is  often  no  direct  way  of  evaluating  a  trigonometric  or  expontential  function 
of  a  Chebyshev  Series.  Instead,  the  function  is  performed  on  a  data  series  converted  from 
the  argument  Chebyshev  Series.  The  resulting  polynomial  is  then  reconverted  back  into  a 
Chebyshev  Series. 

E-4.4.2  Integration  and  Differentiation 

Differentiating  a  Chebyshev  Series  can  be  done  easily  by  differentiating  the 
recursion  formula  for  the  Chebyshev  Polynomials.  Recall: 


Differentiating: 


Tl  +  l(x)  =  2xT,(x)-Ti_1(x) 


dTi  +  i(x)         dT;(x)  dT,_x(x) 

-^^  =  2x-^  +  2Tl(x) ^— 

dx  dx  dx 


where 


</7-q(*) 
dx 

dx 

The  goal  is  to  generate  the  following  n  x  n  matrix: 

dT0(x)     dTx(x)     dT2(x)  dTn_x{x) 


ADT- 


dx  dx  dx  dx 


The  columns  of  ADT  can  be  solved  recursively  once  we  define  matrix  AXT  for 
multiplying  a  Chebyshev  Series  vector  by  x. 

A:r((A)  =  i(r(_1(x)  +  ri+1(A-)) 
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*xr 


0 

2 

0 

0      . 

.      0 

0 

1 

0 

1 

2 

0     . 

.      0 

0 

0 

1 

2 

0 

1 
2      ' 

..     0 

0 

0 

0 

1 
2 

0     . 

.      0 

0 

0  0  0  0. 
0  0  0  0. 
0     0     0     0. 


.      0 


^ 


Note  that  the  last  row  of  AXT  has  been  eliminated  to  make  the  matrix  square.  This 
will  not  cause  any  problems  since  in  the  recursion  formula  which  follows,  the  last 
coefficient  of  the  vector  multiplying  AXT  is  always  zero. 

Let  ADJi:J}  represent  the  /the  column  of  ADT.  Let  /  be  the  n  x  n  identity  matrix. 
The  recursion  formula  states: 

ADT(:,i  +  2)  =  2AXTADT(:,i  +  l)  +  2/(:,/  +  1)  -ADT(:,i) 

i<i<n- 2 

Once  ADT  has  been  constructed,  it  can  be  used  to  calculate  derivatives.  Let  W  and  Y 
be  vectors  of  Chebyshev  Series  coefficient  of  size  n.  Then  the  following  statements  are 
identical: 


Y  = 


dW 
dx 


Y  =  ADTW 


Of  course  the  nth  coefficient  of  Y  will  always  be  zero  since  the  nth  row  (as  well  as 
the  first  column)  of  ADT  will  always  be  populated  with  zeros. 
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Integration  is  a  bit  more  complex.  In  general,  the  problem  is  to  solve  the  following 
equation: 


Y  =  Y0+        Wdx 

X=-I 

First,  the  w+1  x  n  indefinite  integral  matrix  Sjj  should  be  found.  The  easiest  way  of 
generating  SIT  begins  by  adding  an  additional  column  to  ADT  using  the  same  recursion 
formula  to  form  the  n  x  w+1  matrix  ADT1.  SlT  is  simply  the  pseudo-inverse  of  AOT1: 

Ojj  =  {ADTjADTj )    ADT] 

The  next  step  is  to  evaluate  the  integral  at  x  =  -1.  This  can  be  done  by  multplying 
the  following  row  vector  by  SlL: 

X_x  =  [\      -1     1      -1     ...     (-1)"-1] 

The  first  row  of  S^  contains  all  zeros.  If  this  row  is  replaced  by  -S.j  and  the 
resulting  matrix  called  SDT,  we  have  all  the  pieces  for  calculating  the  integral  of  a 
Chebyshev  Series: 

Y  =  SDTW  +  Y0 

Of  course,  the  vector  Y  may  have  to  be  truncated  or  padded  with  zeros  as  required. 
E-4.4.3  Switching  Functions 

Switching  functions  for  Chebyshev  Series  can  not  be  evaluated  as  easily  as  the 
switching  functions  for  Legendre  Series  due  to  the  weighting  function  r(x)  for  the 
Chebyshev  Polynomials.  Recall: 


i  r  fix)  J 

■i=-  \    ,  dx 


2  \f{x)Tm_x(x) 
c„  =  -  I  — ,  dx 

x2 


=  2lCf(x)Tm. 


The  situation  is  not  hopeless  due  to  the  following  integral  equations: 
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=  sin  (x) 


vr^ 


=wr 


/ 


2™ 


vr: 


*ft  = 


(2m)! 


(m\f 


-V 


1-* 


;     J     _r!(r-_l)!_A>-1  +  sin-1(A-) 


=  1     2 


2m-2r  +  l 


(2r)! 


»2wi 


/ 


,2m +  1 


vrr 


^a-=-Vi-a-2  i 


(2r)!(W!)2      m_r  j, 
■r      x 


~i(2m  +  l)!(r!)2 


Thus  if  y)  is  the  Chebyshev  Series  representation  of  the  /th  piece  of  Chebyshev 
Series  waveform  Y  and  x0(f)  is  the  x  coordinate  of  the  ending  point  of  the/th  piece,  then 
we  can  state  the  following: 


Y  = 


*o(0)  =  -l 
x0(m)  =  l 


*00> 

"'"J-.,  VI 


/>) 


<fe 


Tiy  =  1    J        \\-x 


The  process  should  now  be  clear: 

1 .  Convert  fj(x)  to  a  polynomial  representation  fPJ{x) 
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2.  Multiply  fPJ(x)  by  the  polynomial  representation  for  Tt(x)  and  call  the  resulting 

polynomial  f^x). 

3.  Use  the  above  integral  equations  to  evaluate  at  x  =  x0(j)  and  x  =  x0(j-l)  the 

integral  off(J(x)  term  by  term  to  form  the  /th  component  of  F,  called  Y*. 

4.  Sum  up  Yj,  overy  to  produce  Yt. 

While  the  above  process  will  produce  the  correct  values  for  Yh  the  following 
method  is  much  easier  to  calculate  and  produces  nearly  identical  results: 

1.  Convert  fj(x)  to  a  Legendre  Series  representation  f^x) 

2.  Calculate  the  Legendre  Series  Representation  Yt  of  Y  with  the  methods  of  section 

E-4.3.3. 

3.  Convert  Yt  to  the  Chebyshev  Series  Representation  Y. 
E-4.4.4  Waveform  Smoothing 

There  is  no  obvious  method  for  performing  waveform  smoothing  in  the  Chebyshev 
Series  spectral  domain.  Instead,  the  waveform  should  be  converted  to  a  polynomial 
expansion  and  the  methods  of  section  E^4.2.4  employed. 
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Appendix  F:  Model  Development 

The  following  electrical  power  system  models  have  been  develped  in  support  of 
WAVESIM: 

Three  Phase  Synchronous  Generator 

Voltage  Regulator 

Prime  Mover 

Three  Phase  Switch 

Transmission  Line 

Constant  Impedance  Loads 

Reduction  Gear 

Propeller 

Ship  Dynamics 

Pulse  Generator 

Induction  Motor 
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F-l  3  Phase  Synchronous  Machine  Model 

Two  models  are  presented  for  simulating  a  three  phase  synchronous  model.  Trie  first 
expresses  the  voltages  and  currents  in  terms  of  a  rotating  reference  frame  (dqO)  rotating  at 
the  base  frequency.  This  model  is  suitable  for  studies  where  the  voltages  and  currents  are 
balanced,  nearly  sinusoidal,  and  near  the  base  frequency.  For  fast  transients  or  unbalanced 
operations,  the  actual  instantaneous  values  for  the  voltages  and  currents  should  be  used  (abc 
frame).  Both  models  are  very  similar  in  that  the  terminal  values  are  transformed  to  a 
rotating  reference  frame  alligned  with  the  rotor  of  the  machine  (Park's  Transformation) 

F-l.l  DQO  Model 
Interface  Variables 


Terminal 

Stator  Direct 
Stator  Quadrature 
Stator  Zero  Sequence 

Mechanical 


Field  Voltage 


Stator  D-axis  Current 
Stator  Q-axis  Current 
Stator  0-axis  Current 
Field  Current 


Potential  Variable        Flow  Variables    (KCL  Group)  Type 


VD  (import) 
VQ  (import) 
V0  (import) 

com  (import) 

VFD  (import) 

/DI  (export) 
/QI  (export) 
/0I  (export) 
In  (export) 


/D  (export) 
7Q  (export) 
If,  (export) 

Tm  (export) 


(1)  Normal 
(1)  Normal 
(1)  Normal 

(0)  Normal 

Information 

Information 
Information 
Information 
Information 


The  import  x^  and  export  x     vectors  are  defined  by 


exp 


■*imp 


v  FD 
03„ 


*«/>  = 


'0 

h 

Tm 
hi 
hi 
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Parameters 

xd  Synchronous  Reactance  (PU) 

xq  Negative  Sequence  Reactance  (PU) 

x/  Transient  Reactance  (PU) 

xd"  D-axis  Subtransient  Reactance  (PU) 

x"  Q-axis  Subtransient  Reactance  (PU) 

Xj  Armature  Leakage  Reactance  (PU) 

Tdo'  Transient  Open  Circuit  Time  Constant  (seconds) 

Tdo"  D-axis  Subtransient  OC  Time  Constant  (seconds) 

Tqo"  Q-axis  Subtransient  OC  Time  Constant  (seconds) 

T^  Armature  Time  Constant  (sec) 

H  Inertia  Constant  (sec) 

pp  Pole  Pairs 

ifnl  Field  Current  for  no  load  rated  voltage  (amps) 

ti)bs  Base  System  Frequency  (rad/sec) 

0  Base  System  Angle  (radians) 


'bs 


VSB  Base  System  Voltage  (volts) 

PSB  Base  System  Power  (watts) 

VMS  Base  Machine  Voltage  (volts) 

PMB  Base  Machine  Power  (watts) 

States 

Qs  rotor  angle  wit  to  synchronous  frame  (rad) 

y^  D-axis  flux -linkage  (PU) 

Y?5  Q-axis  flux -linkage  (PU) 

eqS"  Q-axis  voltage  behind  subtransient  reactance  (PU) 

e^"  D-axis  voltage  behind  subtransient  reactance  (PU) 

eqS'  Q-axis  voltage  behind  transient  reactance  (PU) 
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Equations 
Constant  Definitions 

Base  Quantities 


Other  Constants 


IP  SB 

'sB  ~ 

''Wa 

*  SB 

PsB 

<&sb 

*MB  = 

IP  MB 

'Wmb 

T     - 

1  MB 

PpPm 

%, 

J  =  *fnl\Xd~Xa 

V 

Pmb 

Xod 

—  Xd       Xal 

xL 

V 

t 

Xd  ~  Xd 

rf 

Xf 

<$bsTdo' 

Xad 

xhi 

tf 

%d  ~  %d 


xd~xd 

a  =  -7 ; 

Xd    ~  Xd 
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Angle  Calculations 


Q  =  j(abs-amPP)dr  +  Qs 


G  =  S((dbs-a>mPp)  +  QS0 

Ce  =  cos(0) 
Se  =  sin(0) 

Variable  Rotation  and  Scaling 


v  = 


vfd 


v  = 


Vn 


v 


FD 


R.  = 


Vsb  VSB 

7T-M{Ce)     ~M(Se)       0         0 


MB 


VsB  VsB 

77^M(Se)       7^M(Ce)         0         0 
vmb  **< 


MB 


0 

0 
v=R..V 


SB 


V> 


MB 


0 


V 


SB 


>. 
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Solving  the  electrical  dynamical  equations 

The  five  electrical  dynamical  equations  must  be  solved  simultaneously.  Since  the 
Integration  Matrix  and  Multiplication  Matrix  are  linear  matrices,  the  entire  problem 
becomes  a  linear  process.  Hence  the  system  of  equations  can  be  represented  by  a  matrix 
equation. 

First  define  the  integration  and  multiplication  matrices 


/ 


x{t)dt  =  Sx+xs     ;     SeW"     xs  €  3T 
xy=M(y)x     ;     M  €  9TX" 


Now  we  define  the  system  of  equations 
5 


A  = 


1  + 

fad 

SM«*mPp) 
/       >, 

Xj       Xj 

-S 


T    "r  ' 

1  do    xd 

0 
0 


-Olf(aW>,) 

S 


1  + 


aq 


T  "x  ' 

'  qo     -*q 


0 


s_ 

Tad 
0 


I+S 


T    "r  " 

1  do    xd 


0 
a-1 


T   ' 

-»  An 


0 

s_ 

T 

0 


I+S 


x 

qo     ^q 


0 


1  do 

0 


7+5 


do 


a 

1  do 


Vd 


Le* 
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B 


0* 

0 

0 

0 

0 

©fa 

0 

0 

0 

0 

0 

0 

0 

0 

0 

0 

aJ 


0       0      0     — 


7  J 


*s  = 


7  0  0  0  0' 
0/000 
0  0/00 
0  0  0/0 
0     0     0     0/ 


V4S0 

%so 

CqSO 

cdSO 

/ 
eqSQ 


b=Bvv+Bss0 


x=A~*b 
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Calculating  Export  Variables 

First  the  currents  in  machine  reference  frame 


r  = 


V« 


C  = 


1 

0 

1 

0 

0 

0 

1 

If 

0 

1 
< 

0 

0 

0 

0 

0 

0 

0 

0 

*w 

0 

*/ 

XaAXf~  Xkd) 

Xad\Xf~  Xhd) 

L  -  Cx 

Now  the  currents  in  system  reference  frame 


I  = 


'FD 


Rj  = 


lm 


'SB 


M(Ce) 


-—M(Se) 


'SB 


0 
0 


'MB 


'SB 


M(SQ)       0       0 


'MB 


'SB 


M(Ce)      0       0 


/.=*/'. 


'MB 

0 


275 


Torque  Equation 


epu  T  d '  q  T  q   d 

2Hppd(x>m 


ox,     dt 


>bs 


T=M{yd)i-M{yq)i 


epu 


q)"d 


Tac= — —  S    »„ 

ace  n 


1  SB 

T  =  —  (T     -T    ) 

m         rj-i         V     ace  epu' 

1  MB 


^DS  ~ 


N 

N 

0 

N 

N 

N 

0 

N 

0 

0 

0 

0 

N 

N 

0 

N 

N 

N 

0 

N 

N 

N 

0 

N 

0 

0 

0 

0 

Structural  Jacobian 

The  structural  jacobian  for  the  DQO  model  is  given  by: 

N' 

N 

0 

N 

N 

N 

0 

Jacobian  Calculations 

Calculating  the  jacobian  of  the  export  variables  with  respect  to  the  import  variables 
is  straight  forward  with  the  exception  of  the  partials  with  respect  to  the  mechanical 
frequency.  First  of  all,  nothing  depends  on  V0,  hence  all  of  its  partials  are  zero.  In  the 
following  derivations,  the  Device  Jacobian  is  partitioned  such  that  the  voltages  and 
currents  are  split  from  the  mechanical  speed  and  torque. 

a/,         . 
zv=R'CAB^ 
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Calculating  the  partials  with  respect  to  the  mechancial  frequency: 


Ax=BvRvV+Bss0 


.   dx       dA  n   dRv  , , 

A; —  +  - — x=B- — V 


3om    dcon 


vaco„ 


dx_ 
3co„ 


=  A 


-1 


B 


dRv    .      dA 


v3co„ 


V- 


3co„ 


»•  =«,C  * +i*LC;c 


5(0, 


3com    3co„ 


where 


and 


dA_ 
3co„, 


0 

0 
0 
0 


SPP 

0 

0 

0" 

0 

0 

0 

0 

0 

0 

0 

0 

0 

0 

0 

0 

0 

0 

0 

0_ 

dcom 


=  SP, 


V. 


SB 


V: 


M(Se)Spf 


MB 


d(£>„ 


V 


SB 


V 


MB 


M(CQ)SPf 

0 
0 


I7 


SB 


VsB_ 


MB 


M(Ce)SPp     0     0 
M(Se)Spp     0     0 


0 
0 


0     0 
0     0 
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dR, 
d(Om 


'MB 


lSB 


'MB 


M(Se)SPp      —r-M(Ce)SPp     0     0 


lSB 


'MB 


lSB 


M(Ce)Spf 

0 
0 


-^M(Se)Spp 

JSB 

0 

0 

0 

0 

0 

0 

0 

0 

The  Torque  equation  Jacobians  are  given  by: 

~dV~~Tm  dV 


dT 


cpu 


dV 


=  M(yJ)^  +  M(iq) 


..^Vi 


dv 


M(Uav 


W="   °  °  °   0]l 


dV, 


dx 


a7  =  [0  7  °  °  0]^ 


d/,,  dz, 

^=[/  °  °  0]aK 


d/,  d/. 


Now  with  respect  to  the  mechanical  frequency: 


3T-      TSB 


dec, 


'm        ■'Mfi 


dTacc     dTepu 
d(Om      d(Om 


dcom  "     (£>bs 


dT 


cpu 


dL 


dV 


5/„ 


d(D„ 


=  ^(Vrf)^r+^(U^r-M(vJ^— -M(ij 


dec, 


dec, 


dco„ 


^V, 
dco„ 
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pi=v    0    0    0    0]^ 

d(Om  dco,, 


3co„ 


=  [0/000] 


5co„ 


9/j  die 

=  [10    0    0] 


3oo, 


3oo„ 


9/"  die 

1  =[0     /     0     0] 


3co, 


3co„ 


Putting  the  Jacobian  all  together: 


JD  = 


dID 

dID 

dvD 

dVQ 

dle 

a/e 

dvD 

dVQ 

0 

0 

ZTm 

arm 

dvD 

dVQ 

dvD 

dID 
dVQ 

dIQ 

dIQ 

dVD     dVQ 

0         0 


0 

0 
0 
0 


0 
0 


a//> 

% 

dvF 

awm 

dIQ 

a/e 

dVF 

acora 

0 

0 

37". 

arm 

dVF 

acom 

a^ 

a/D 

9V/T 

acow 

a/e 

a/e 

av> 

o 


aco„ 

o 
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F-1.2  ABC  Mode! 
Interface  Variables 

Terminal 

Stator  Phase  A 
Stator  Phase  B 
Stator  Phase  C 

Mechanical 


Potential  Variable        Flow  Variables    (KCL  Group)  Type 


VA  (import) 
VB  (import) 
Vc  (import) 

(0m  (import) 


/A  (export) 
/B  (export) 
/c  (export) 


(1)  Normal 
( 1 )  Normal 
( 1 )  Normal 


Tm  (export)  (0)  Normal 


Field  Voltage 

Stator  Phase  A  Current 
Stator  Phase  B  Current 
Stator  Phase  C  Current 
Field  Current 


VVd  (import) 

IM  (export) 
/BI  (export) 
/CI  (export) 
IF  (export) 

The  import  ximp  and  export  xexp  vectors  are  defined  by: 


Information 

Information 
Information 
Information 
Information 


■*imp 


V 


FD 
(0„ 


Parameters 

All  Parameters  are  identical  to  the  DQO  Model 

States 

All  States  are  identical  to  the  DQO  Model 
Equations 

Constant  Definitions 

All  Constants  definitions  are  identical  to  the  DQO  Model 


x     = 


'Dl 


<QI 


'()/ 
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Angle  Calculations 

For  this  model,  the  angle  is  the  actual  rotor  angle  of  the  synchronous  machine: 

&  =  )®mPpdt+QsO 

0  =  S(timpp  +  QSo 
Note:  When  calculating  0S/  it  would  be  wise  to  limit  its  range  to  ±k. 

Variable  Rotation  and  Scaling 

To  convert  from  the  V  vector  to  the  v  vector,  Parks  transformation  should  be  used: 


V  = 


V 


FD 


R..= 


2V 


SB 


3V, 


MP 


( 


M(cos(0))        M 


cos 


0- 
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\\ 


M(sin(6))     -M 

1 

2 


f      f 
sin 


J 


(      ( 


0- 


3 
2^ 


M 


cos 


-M\  sin 


J  J 


0 


]. 

2 

0 


1 

2 

0 
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+y 


0 
0 
0 

2V„ 


v=RvV 

Solving  the  electrical  dynamical  equations 

The  electrical  dynamical  equations  are  solved  in  exactly  the  same  way  as  for  the 
DQO  model. 
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Calculating  Explicit  Variables 


The   only   difference   for  calculating  the   explicit   variables   are   the   following 
matrices: 


/  = 


h 

ho 


R,= 


'MB 


'SB 


M(cos(0)) 
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M 
M\  cos 


cos  0  - 

( 


0  + 


V 


3  J  J 

-11 
3  J  J 


-M 
-M 


-M(sin(0)) 
sinf  0  — 


( 


sin 


V 


3  )j 
2n^ 


0  +  y 


0 


0 


0 
0 


'.'.ft 


'MB 


Jds  — 


Structural  Jacobian 

The  structural  jacobian  for  the  ABC  model  is  given  by: 

N  N  N  N  N' 

N  N  N  N  N 

N  N  N  N  N 

N  N  N  N  N 

N  N  N  N  N 

N  N  N  N  N 

^N  N  N  N  N 

Jacobian  Calculations 

The  only  differences  for  calculating  the  jacobian  matrices  are  the  following: 

a© 


9co„ 


sp, 
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dRv     2V, 


SB 


9com     3K 


MH 


-M(sin(0))5p, 


M 


sin 


-Af(cos(0))Sp,      -M 

0 
0 


-? 


5A 


cos 


0- 

0 

0 


In 


\\ 


-M 


sin 


e+y 


\\ 


Spp      -M 


( ~     27C 
cos  0  +  — 

l        3 
0 

0 


Sp, 

0 

Sp, 

0 

0 

0_ 

a^_A 

9co„ 


'.ST? 


-M(sin(0))5p 


-M 


-M  sin 


-M(cos(0))Sp 


-M  cos 


/ 


0- 


-  M\  cos 


0  + 


V 


0 


0 

0" 

0 

0 

0 

0 

0 

0 

Putting  the  Jacobian  all  together: 


Jd  = 


5com 

5com 
dlc 
3com 

a^ 
acom 

_a/*_ 

3com 
3com 

a/c 
a^   dvB    dvc    dvF   a^ 


a/. 

a/. 

a/. 

a/. 

dvA 

av^ 

a^c 

avf 

diB 

a/5 

a/* 

a/5 

dVA 

dvB 

a^c 

avf 

a/c 

a/c 

a/c 

a/c 

avA 

av, 

dvc 

avf 

arffl 

arm 

arm 

arm 

a^ 

avfi 

avc 

dvF 

a/. 

*A 

a/. 

a/. 

av^ 

dvB 

a\/c 

avv 

a/fl 

a/B 

diB 

a/5 

*vA 

3v, 

dVc 

avf 

dic 

a/c 

dlc 

die 
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F-2  Voltage  Regulator  Model 

This  is  a  simple  voltage  regulator  model.  The  voltage  regulator  is  assumed  to  be  of  a 
PI  type  controller.  This  design  does  not  have  any  clipping  on  the  output  waveform  to 
ensure  the  field  voltage  is  kept  within  a  reasonable  range.  This  model  is  intended  for  single 
generator  operation  since  it  has  no  provision  for  reactive  power  sharing  with  paralleled 
generators. 

F-2.1  DQO  Model 
Interface  Variables 


Terminal 

Line  Direct  Voltage 
Line  Quadrature  Voltage 
Reference  Voltage 
Field  Voltage 


Potential  Variable        Flow  Variables    Type 


VD  (import) 
VQ  (import) 
Vref  (import) 
VFD  (export) 


The  import  ximp  and  export  xexp  vectors  are  defined  by: 


*imp 


V, 


V. 


ref 


Parameters 


K 

Kdqo 

States 


Integrating  factor  (1  /  sec) 

Proportional  factor  (PU) 

Voltage  Magnitude  Conversion  factor  (PU) 


Field  Voltage 


Equations 

Calculate  the  terminal  voltage: 

V,  =  kDQ0^VD-VD  +  VQ-VQ 
Calculate  the  error  voltage: 


V     =V    -V 

V  err         ¥  ref        V I 


Information 
Information 
Information 
Information 


^p  =  [Vfd] 
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Calculate  the  Field  Voltage: 


-J* 


VFD=  \k1Verrdt+kpVerr  +  VfdS 


Structural  Jacobian 

The  structural  jacobian  for  the  DQO  model  is  given  by: 

JDS  =  [N     N     L) 

Jacobian 

3V» 


3IW-V+V 


dV, 


FD 


dv, 


=  -kjS-kpI 


dV^JV^dV, 
dVD  ~  dV,  dVD 

dvfE  =  dvI»dvL 
dvQ  ~  dv,  dvQ 

Note  the  partials  of  V,  with  respect  to  VD  and  VQ  must  be  determined  from  the  square  root 
function: 


The  device  jacobian  is  given  by: 


dv, 

dvD~ 

-k      V-l 

KDQO  y 

dv, 

dVQ~ 

KDQO    y 

ven  by: 

Jo  = 

\dvFD 
_dvD 

dVFD      dVFDl 
dVQ      dVref_ 
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F-2.2  ABC  Model 


Interface  Variables 


Terminal 

Potential  Variable        Row  Variables    Type 

Phase  A  Voltage 

VA  (import)                                                Infonnation 

Phase  B  Voltage 

VB  (import)                                               Information 

Phase  C  Voltage 

Vc  (import)                                                Infonnation 

Reference  Voltage 

Vrej  (import)                                               Infonnation 

Field  Voltage 

VFD  (export)                                               Information 

The  import  x^  and  export  xexp  vectors  are  given  by: 

imp 

~vA- 
vr< 

^  =  {Vfd\ 

ki 


yABC 


Integrating  factor  (1  /  sec) 

Proportional  factor  (PU) 

Voltage  Magnitude  conversion  factor  (PU) 


States 


VfdS  Field  Voltage 


Equations 

Calculate  and  subtract  out  the  DC  offset  of  the  common  potential: 

VA  +  VB  +  VC 


Vo  =  - 

3 

Vao 

=  vA- 

Vo 

y  BO 

=  vB- 

v0 

y  CO 

=  vc- 

Vo 
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Calculate  the  Terminal  voltage1: 


4 


V,  =  WV  3  Wao  ■  VA0  +  VB0  ■  VB0  +  Vco  ■  Vco) 


Calculate  the  Error  voltage: 


Calculate  the  Field  Voltage: 


V     =  V    -V 

V  err         V  ref        V  t 


VFD  =  fk, 


V„Mt  +  kV+VfdS 

p      err  yao 


Note  1:  Derivation  of  Terminal  Voltage: 

Assume  phase  voltages  are  balanced  three  phase: 

VA0  =  VTcos(Q) 


yBo  =  vTc°s 


0  + 


27^ 


V 


J 


Vco  =  VT  cos 


fa-*] 

I         3  J 


72      ,    «/2      ,   .,2  VT 


V^  +  V^  +  V^=-^(l+cos(20)  + 


(  4t0 

1  +  cos(20)  cos  —    -sin(20)sin 

V  3  ) 


Un^ 


+ 


^  *  ) 


l+cos(20)cos 


(Ak\ 
,3  J 


+  sin(20)sin 


Uk^ 


V3y 


y2  +y2  +  y2   =~v2 

vao  T  v  bo  ^  y  co     2 


Structural  Jacobian 

The  structural  jacobian  for  the  ABC  model  is  given  by: 

JDS  =  [N     N     N     L) 
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Jacobian 


dvFD 

dv,      k,b    v 
dvFD   dvFDdv, 


dvA 

'  dV,  dVA 

dvFD 

dVFD  dV, 

dvB 

dV,  dvB 

dvFD 

dVFD  dV, 

dVc       dV,  dVc 

Note  the  partials  of  V,  with  respect  to  VA,  VB,  and  Vc  must  be  determined  from  the  square 
root  function: 

dV,  VA0 


dVM     ™CV,    \3 


-\IT 


-~   A, 


;  V  3 


av50  ™c  k 


3V,   _        V„ .  /2 


',    V  3 


9VC0    '^c  K    V  3 


3v;    2  avf    1  av,    1  dv, 


dVA     3dVM     3dVB0     3dVC0 

dVt       l  dV,     2  a^r     1  dV, 
+ 


dVB        3dVA0     3dVB0     3dV, 


AO       ~>uv  BO       ~>V\  CO 


dV,         1  dV,      1  dV,      2  dV, 

+-■ 


dVr       3dVM     3dVB0    3dV 


AO      ->  v K  so      -,"rco 
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The  device  jacobian  is  given  by: 


JD  = 


dV 


FD 


dVm       dVm       dV, 


FD 


FD 


dVA       dVB       dVc      dVre 
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F-3  Prime  Mover 

This  is  a  rather  crude  model  of  a  PI  controller  on  a  prime  mover.  The  dynamics  of  the 
controller  are  assumed  to  dominate  the  response  of  the  prime  mover. 

Interface  Variables 

Terminal  Potential  Variable         Flow  Variables     (KCL  Group)  Type 

Mechanical  com  (import)  Tm  (export)  (0)  Normal 

Information  ($ref  (import)  Information 

The  import  x^  and  export  xexp  vectors  are  defined  by: 


X-      = 


co„ 


°v 


xap  =  [TJ 


Parameters 

kx  Integrating  Torque  factor  (1  /  sec) 

kP  Proportional  Torque  factor  (PU) 

(Obs  base  frequency  (rad/sec) 

PSB  base  System  Power  (watts) 

Pmb  base  Machine  Power  (watts) 

States 

T^  mechanical  torque 

Equations 

kj 


T_  = 


'MB 


*SB 

Structural  Jacobian 

The  structural  jacobian  for  the  Prime  Mover  model  is  given  by 

JDS  =  [L     L] 


+r«, 


-290 


Jacobian 


J?" 

3cor, 


ar„ 


DSBU>bs' 


/*= 


3com        dco, 


4 

ar„ 


3com      dcon 


F-4  Three  Phase  Switch 


M.1  DQO  Model 

Interface  Variables 

Terminal 

Potential  Vaj 

TD1 

VDI  (Import) 

TQl 

VQ1  (Import) 

T01 

V0I  (Import) 

TD2 

VD2  (Import) 

TQ2 

VQ2  (Import) 

T02 

V02  (Import) 

Flow  Variables 

ID1  (Export) 
IQ1  (Export) 

101  (Export) 
ID2  (Export) 
IQ2  (Export) 

102  (Export) 


SW  Sw  (Import) 

All  Interface  variables  are  on  a  Per  Unit  (PU)  Basis 
The  import  x^  and  export  xexp  vectors  are  given  by: 


(KCL  Group)  Type 

(1)  Normal 

(2)  Normal 

(3)  Normal 

(1)  Normal 

(2)  Normal 

(3)  Normal 

Information 


Y 


pi 


imp 


vm 


exp 


V, 


02 


'D2 
*Q2 

A, 


291 


Parameters 


Goff 
States 


On  Conductance  (PU) 
Off  Conductance  (PU) 


There  are  no  states  for  this  model. 


Equations 

The  equations  for  the  switch  are  very  simple.  First,  we  define  the  conductance  G  of 
the  waveform: 


If 

Then 

Else 


Sw>0 


G=G 
G=G 


off 


Now  Generate  the  Conductance  Matrix  GD: 


GD  = 


M{G) 

0 

0 

M(-G) 

0 

0 

0 

0 

M(G) 

0 

0 

M(-G) 

0 

0 

0 

0 

M(G) 

0 

0 

M(-G) 

0 

M{-G) 

0 

0 

M(G) 

0 

0 

0 

0 

M(-G) 

0 

0 

M(G) 

0 

0 

0 

0 

M(-G) 

0 

0 

M(G) 

0 

The  export  variables  are  simply: 


Xexp  ~  ^JDXimp 


Structural  Jacobian 

The  structural  jacobian  is  given  by: 
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/dS  ~ 


N  0      0     N     0      0     N 

0  N     0      0     N     0     N 

0  0     N      0      0     N     N 

N  0      0     N     0      0     N 

0  N     0      0     N     0     N 

^0  0     N     0      0     N     N 

Jacobian  Calculations 

The  jacobian  matrix  is  very  similar  to  GD: 

M(G)          0              0  M(-G)         0              0         M(VD1-VD2) 

0          M(G)          0  0         M{-G)         0         M(Ve;-Vy 

0              0          M{G)  0              0         M(-G)     MiV^-V^) 

M{-G)         0              0  M(G)           0               0         M(VD2-VD1) 

0         M(-G)         0  0          M(G)          0         M(Vc,-Ve;) 

0              0         M(-G)  0              0          M(G)      M(Vm-V0i) 

Where  rj-  is  determined  by  the  If-Then-EIse  function. 


/*  = 


asH- 

3G 

dsw 

dG_ 
dSw 

dG_ 

dSw 
dG_ 

l)dsw 

dG 


dSw 
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F-4.2  ABC  Model 
Interface  Variables 

Terminal 

TA1 
TBI 
TCI 
TA2 
TB2 
TC2 


Potential  Variable        Flow  Variables 


VM  (Import) 
VB1  (Import) 
VCI  (Import) 
V^  (Import) 


1^  (Export) 
IB1  (Export) 
IC1  (Export) 
1^  (Export) 
IB2  (Export) 


VB2  (Import) 

VC2  (Import)  IC2  (Export) 

SW  Sw  (Import) 

The  import  x^  and  export  xexp  vectors  are  given  by: 


X-      = 


V 


Al 


v 


PI 


V, 


ci 

VA2 

vC2 


x~p  = 


(KCL  Group)  Type 

(1)  Normal 

(2)  Normal 

(3)  Normal 

(1)  Normal 

(2)  Normal 

(3)  Normal 

Information 


'AJ 

hi 

1*2 
h2 


Parameters 


voff 
States 


On  Conductance  (PU) 
Off  Conductance  (PU) 


There  are  no  states  for  this  model. 


Equations 
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The  equations  for  the  switch  are  very  simple.  First,  we  define  the  conductance  G  of 


the  waveform: 


If 

Then 

Else 


Sw>0 


G=G 
G=G 


off 


Now  Generate  the  Conductance  Matrix  GD: 


'  M(G) 

0 

0 

M(-G) 

0 

0 

0 

0 

M(G) 

0 

0 

M(-G) 

0 

0 

GD  = 

0 

0 

M(G) 

0 

0 

M(-G) 

0 

M(-G) 

0 

0 

M(G) 

0 

0 

0 

0 

M(-G) 

0 

0 

M{G) 

0 

0 

0 

0 

M(-G) 

0 

0 

M(G) 

0 

The  export  variables  are  simply: 


Xexp  ~  ^D^imp 


Structural  Jacobian 


^ds  — 


N  0  0  N  0  0  N 

0  N  0  0  N  0  N 

0  0  N  0  0  N  N 

N  0  0  N  0  0  N 

0  N  0  0  N  0  N 

0  0  N  0  0  N  N 
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JD  = 


Jacobian  Calculations 

The  jacobian  matrix  is  very  similar  to  GD. 

M{G)          0              0         M(-G)         0  0  MiVu-Vu) 

0          M(G)          0              0         M(-G)  0  M(VB1-VB2) 

0              0          M(G)          0              0  M(-G)  M(VC1-VC2) 

Af(-G)         0              0          M(G)          0  0  MiV^-Vu) 

0         M(-G)         0              0          M(G)  0  M(Vfi2-Vw) 

0              0         M(-G)         0              0  M(G)  M(VC2-VC1) 

Where  rr-  is  determined  by  the  If-Then-Else  function. 


3SH, 

3G 

35H- 

3G 

dSw 

dG_ 

dSw 

3G 

asH- 
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F-5  Transmission  Line 


DQO  Model 
Interface  Variables 

Terminal 


Potential  Variable         Flow  Variables    (KCL  Group)  Type 


T„,  VDi  (Import) 

TQ1  VQ1  (Import) 

T0,  V01  (Import) 

Tea  VD2  (Import) 

Tq2  VQ2  (Import) 

Trc  \r02  (Import) 

The  import  x^  and  export  xexp  vectors  are  given  by: 


ID1  (Export) 
IQ1  (Export) 

101  (Export) 
ID2  (Export) 
Ie2  (Export) 

102  (Export) 


imp 


V, 


Dl 


Vox 
VD2 

VQ2 


V. 


(0 


Parameters 


R 
X 

States 


Resistance  (ohms) 
Reactance  (ohms) 


(There  are  no  states  for  this  model) 
Equations 

Constant  Definitions 


G  = 


R 


2   ,    n2 


(1)  Normal 

(2)  Normal 

(3)  Normal 

(1)  Normal 

(2)  Normal 

(3)  Normal 


'Dl 


'Ql 


X-P  = 


*0) 

Id* 
I* 


Xz+R 


Y  =  — 


2    ,    D2 


X*+R 
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Calculate  the  Export  Variables 


JD  = 


G 

-Y 

0 

-G 

Y 

0 

Y 

G 

0 

-Y 

-G 

0 

0 

0 

/ 

r 

0 

0 

J 

-G 

Y 

0 

G 

-y 

0 

-Y 

-G 

0 

y 

G 

0 

0 

0 

7 

r 

0 

0 

/ 

r 

*cxp 

=  JDx 

mp 

Structural  Jacobian 

The  Structural  Jacobian  is  given  by: 


Jds  ~ 


D  D  0     D     D  0 

D  D  ODD  0 

0  0  D      0      0  D 

D  D  0     D     D  0 

D  D  0     Z)     D  0 

0  0  D      0      0  D 


Jacobian  Calculations 


The  matrix  JD  is  the  Jacobian  matrix. 
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ABC  Model 
Interface  Variables 


Terminal 


Potential  Variable         Flow  Variables    (KCL  Group)  Type 


1  Al 
'B, 

?a 

[A2 

B2 
■C2 


V^  (Import) 
VBI  (Import) 
VC1  (Import) 
V^  (Import) 


lM  (Export) 


lB1  (Export) 
IC1  (Export) 
1^  (Export) 
VB2  (Import)  IB2  (Export) 

VC2  (Import)  IC2  (Export) 

The  import  x^p  and  export  xexp  vectors  are  given  by: 


*imp 


V 


Al 


V, 


bi 


V. 


a 


VC2 


(l)Nonnal 

(2)  Normal 

(3)  Normal 

( 1 )  Normal 

(2)  Normal 

(3)  Normal 


'Al 


'til 


exp 


LC1 

hi 

'c2 


Parameters 


R 
G 
L 

States 


Series  Resistance  (ohms) 
Parallel  Conductance  (mhos) 
Inductance  (henries) 


Phase  A  Inductor  Current 
Phase  B  Inductor  Current 
Phase  C  Inductor  Current 


MCL 

Equations 

Each  of  the  three  phases  can  be  treated  independently  of  one  another.     In  the 
equations  which  follow  replace  a  subscripted  X  with  the  appropriate  phase  letter: 

First  write  the  equations  describing  the  phase: 


R 


'   -i~G 


'XI 


V 


XN 


0 


0 


G+I     -I 


Vxi' 

VX2 
*XLO 
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1  x: 


'XL 


-/ 

0 

'Jxi~ 

/    „ 

+ 

0 

-R~G_ 

.v 

0 

/ 

R 


0 

0" 

"V 

G 

0 

V^ 

- 

'XLO_ 

Manipulating  the  first  matrix  equation,  we  can  get  an  expression  for  the  terminal  1 
current: 


G,.  = 


R 


S+RG+I 


J    L 


L 


+  G 


-H 


Ixj  =  G, 


V 


XI 


V 


X2 


lXLO 


Once  this  is  known,  the  other  variables  are  easy  to  calculate: 


VXN~VX1  ~RIX1 


IXL=~\ 


V 


XI 


R 


+  G  V™+— -  +  GV- 


XN 


R 


x: 


'x2  ~      'xi 


Structural  Jacobian 

The  Structural  Jacobian  is  given  by: 


^DS  — 


L  0  0  L  0  0 

0  L  0  0  L  0 

0  0  L  0  0  L 

L  0  0  L  0  0 

0  L  0  0  L  0 

0  0  L  0  0  L 
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Jacobian  Calculations 

The  Jacobian  Matrix  can  be  directly  constructed  from  the  first  element  of  Giy 


Gn 

= 

(R 

u 

S+RG+l) 

fs 

u 

+  G 

J 

'  Gu 

0 

0         -Gn 

0 

0 

0 

Gu 

0           0 

-G 

ii       o 

JD  = 

0 
~GU 

0 
0 

Gu         0 
0         Gu 

0 
0 

~GU 
0 

0 

~GU 

0           0 

Gx 

o 

0 

0 

-Gn        0 

0 

Gu 
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F-6  Constant  Impedance  Loads 
DQO  Model 
Interface  Variables 


Terminal 

Potential  Variable        Flow  Variables 

TD                                          VD  (import)                  ID  (export) 
TQ                                          Vq  (import)                  IQ  (export) 
T0                                           \0  (import)                   I0  (export) 

The  import  x^  and  export  xexp  vectors  are  given  by: 

~vD- 

"V 

*-imp  ~ 

exp 

Parameters 

R                   Load  resistance  (ohms) 
X                  Load  reactance  (ohms) 
Ggnd              Zero  Sequence  conductance  to  ground. 

States 

(There  are  no  states  for  this  model) 

Equations 

First  calculate  the  admitance 

G_  * 

R7+X2 

v-        X 

2    ,    v-2 


R'+X 


Now  calculate  the  Admitance  Matrix: 


G„.= 


G  -Y  0 
Y  G  0 
0       0       G 


gnd 


(KCL  Group)  Type 

(0)  Normal 
(0)  Normal 
(0)  Nonnal 


exp  vi    imp 
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Structural  Jacobian 

The  Structural  Jacobian  is  given  by: 


^DS  — 


D 

D 

0" 

D 

D 

0 

0 

0 

D 

Jacobian  Calculations 

The  jacobian  matrix  is  the  G„  matrix. 
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ABC  Model 
Interface  Variables 

Terminal 
TA 


Potential  Variable        Flow  Variables    (KCL  Group)  Type 


VA  (import) 
VB  (import) 
Vc  (import) 


1A  (export) 
IB  (export) 
Ic  (export) 


(0)  Normal 
(0)  Normal 
(0)  Normal 


The  import  x     and  export  x     vectors  are  given  by 


■^■imp 


Vr 


*exp 


Parameters 


R 
G 
L 
R 


GND 


States 


lAL 


lCL 


Series  Resistance  (ohms) 

Parallel  Conductance  (mhos) 

Inductance  (henries) 

Resistance  of  center  to  Ground  (ohms) 


Phase  A  Inductor  Current 
Phase  B  Inductor  Current 
Phase  C  Inductor  Current 


Equations 

This  load  model  can  be  considered  to  be  a  transmission  line  where  all  the  terminals  of  one 
side  are  connected  together  to  a  resistor  going  to  ground.  As  such,  we  can  use  some  of 
the  derivations  from  the  transmission  line  model: 


G31- 


R 


V 


S+RG+I 


J 


S        ^ 
L+G 


^11-^31 
JX  ~  G\\VX  ~  GUVX2  +  G^XLO 

Vx2  =  (Ia+Ib+Ic)Rcnd 
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This  can  be  rewritten  by  defining  the  following  matrix: 


^ABC  — 


(I+rgndGu)         rgndG\\ 

Rcnd^h  (I  +RgndGu) 


°gndGu 


^■GND^W 

°gndG\\ 


"gnd^u 


Which  allows  the  following  equation  to  be  written: 


'ABC 


h~ 

'Gu 

0 

0  " 

"VA~ 

~G„ 

0 

0 

h 

= 

0 

Gn 

0 

vB 

+ 

0 

GiX 

0 

h 

0 

0 

o„ 

Vc 

0 

0 

Gi 

'ALO 


'BLO 


lCLO 


Or  if  we  rewrite  the  equation: 


"L" 

'Gn 

0 

0  " 

~vA 

h 

~  ^ABC 

0 

Gn 

0 

vB 

h 

0 

0 

Gn_ 

Vc 

+  G 


-i 

ABC 


""31 

0 


0        0 
0 


31 


0        0      G, 


'ALO 


'BLO 


'  CLO 


The  inductor  current  for  phase  X  can  be  determined  from: 


VXN  =  VX-RIX 


Ixl  =  - 


R 


+  G 


VxN+J  +  GRGm)(IA+IB+Ic) 


Structural  Jacobian 

The  structural  jacobian  is  given  by: 


^ds  ~ 


L  L  L 
L  L  L 
L     L     L 
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Jacobian  Calculations 

The  Jacobian  Matrix  is  given  by: 


t  -r~l 

JD  ~  ^AfiCl 


0 

0  " 

Gu 

0 

0 

Gu_ 
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F-7  Reduction  Gear 
Interface  Variables 

Terminal 

SI 
S2 


Potential  Variable         Flow  Variables     (KCL  Group)  Type 

co,  (export)  Tj  (export)  (0)  Normal 

(02  (import)  T2  (import)  (0)  Normal 


The  potential  variables  are  measured  in  radians/second  while  the  flow  variables  are 
measured  in  Newton-meters. 

The  import  x^  and  export  x     vectors  are  given  by: 


x     = 


G>2 


*exp 


CO, 


Parameters 


n. 


n, 


Number  of  teeth  on  shaft  1 . 
Number  of  teeth  on  shaft  2. 

Efficiency  of  Reduction  Gears. 


States 

There  are  no  states  for  this  model. 
Equations 

The  rotational  speed  of  the  shafts  are  proportional  to  the  gear  ratio: 
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The  transmitted  torque  however,  must  be  scaled  by  the  efficiency.  Which  side  of  the 
equation  the  efficiency  applies  depends  on  the  direction  of  the  power  flow: 

if 


then 


else 


r2co2>0 


7-,=--^ 


«1 

r,  = — t2 

n2r\ 


The  first  zero  crossing  of  the  power  should  be  passed  back  to  the  system  as  a 
suggested  recalculation  time. 

Structural  Jacobian 


The  structural  jacobian  is  given  by: 


^ds  — 


D     0 

N     N 


Jacobian  Calculations 

The  jacobian  is  given  by: 


Jd  = 


«2 
"l 

0 

97\ 

ar, 

d(xh 

dT2 

The  partials  of  Tj  depend  on  the  partial  derivatives  of  the  if-then-else  function.  If 
the  direction  of  the  power  flow  remains  constant  over  the  interval,  then  the  partials  are 
given  by: 


9C02 


=  0 


dJ\J\ 

dT2     T2 
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F-8  Propeller 

The  relationship  between  the  torque,  angular  speed,  forward  velocity  and  forces  on  a 
propeller  are  highly  complex  and  nonlinear.  While  much  infonnation  is  known  about  the 
steady-state  operation  of  propellers  traversing  in  the  forward  direction,  little  information  is 
available  for  nonstandard  operating  conditions.  The  classical  approach  is  to  generate  K,  vs  J 


and  Kq  vs  J  curves  where: 


'-£ 


F  =  KT(J)pD4n2 


,5     2 


Tm=KQ{J)pD'n 

where  the  variables  are  described  in  the  following  sections. 

The  classical  approach  works  well  when  V  (speed  of  propeller  with  respect  to  the 
fluid)  and  n  (RPM  of  shaft)  are  both  positive  and  n  is  large  enough  to  bring  /  (advance 
coefficient)  below  about  1.5.  Outside  of  this  range,  little  data  is  provided  for  most 
propellers.  The  classical  approach  breaks  down  completely  when  the  shaft  speed  is  zero 
and  /  is  infinite.  Furthemiore,  there  is  no  way  to  differentiate  between  backing  down  (n 
and  V  both  negative)  and  having  forward  way  on  («  and  Vp  both  positive).  The  method 
used  for  this  model  is  better  suited  for  simulation  studies  because  it  essentially  uses  the 
angle  of  attack  on  the  propeller  blade  as  the  argument  for  the  thrust  and  torque  coefficients. 
This  model  is  based  on  work  conducted  at  the  Naval  Ship  Research  and  Development 
Center,  Annapolis,  MD  by  D.  W.  Baker  and  C.  L.  Patterson  and  reflects  data  and  theory 
developed  by  I.  Ya.  Miniovich. 

Interface  Variables 

Terminal  Potential  Variable         Flow  Variables     (KCL  Group)  Type 

Mechanical  com  (import)  T„  (export)  (0)  Normal 

Hydrodynamic  u  (import)  F  (export)  (0)  Normal 

Note:  units  are  radians! 'second,  Newton-meters,  meter  si  second,  and  Newtons 

The  Import  X^  and  Export  X     vectors  are  defined  by: 
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~com~ 

m 

imp 

u 

~T~ 

x    = 

m 

exp 

F 

Parameters 


D 

w 

p 

CA) 


Cn() 


States 


Diameter  of  Prop  {meters) 
Wake  Fraction  (PU) 

Density  of  water  (kg/m3) 

Thrust  Coefficient  matrix  (unlimited  rows  by  2  columns) 
first  column  is  0  in  radians  [-K  n] 
second  column  is  Thrust  Coefficient  in  PU. 

Torque  Coefficient  matrix  (unlimitd  rows  by  2  columns) 
first  column  is  0  in  radians  [-n  k] 
second  column  is  Torque  Coefficient  in  PU. 


(There  are  no  states  for  this  model) 


Equations 


V  =(l-w)« 


n  = 


(0, 

2k 


e  =  at<m2(nD,Vp) 
F=-<:T{e)?D\V2p  +  n7D2) 

Tm  =  CQ(e)pD\V2p  +  n2D2) 

Normally,  Cj{)  and  CQ()  are  specified  as  data  points.  Hence  some  type  of 
interpolations  scheme  is  needed  to  determine  the  value  of  theses  functions  at  intermediate 
points,  as  well  as  the  value  of  the  first  derivative. 

Device  Structural  Jacobian 

The  Device  Structural  Jacobian  for  all  waveforms  is  given  by: 
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^DS  ~ 


N     N' 
N     N 


Jacobian  Calculations 

Calculate  partials  with  respect  to  intermediate  variables 


dF 


dF 


=  d-w) 

du  dv 


du 


=  (l-w) 


dF_ 
dV„ 


dF       1  dF 


3co„     In  dn 


dTm       1  dTn 


d(.om     2n  dn 


Calculate  the  partials 
dF_ 

dv„ 


=  -pD 


,     ,  ,  dcT(e) 

2CT(G)Vp  +  (V2  +  n2D2) 


\ 


dV, 


p    J 


dv 


=  -pD 
=  pD 


dF_       J 
dn' 

dT, 


?2    ,       2,-v2, 


2CT(G)D  n+(Vp  +  nD z) 


2cQ(e)vp+(v;+n^) 


dCT(Q) 
dn 


\ 


dv 


p   ) 


-^-  =  pD'  2CQ(G)D2n+(V2  +  n2D2)-^ 
dn  y      *  p  dn 

Calculate  the  partial  of  0  with  respect  to  V  and  n. 

de 


i 

rlD 


nD 
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dn 


n2D 

V  nD 


Of  course,  the  partials  of  CjiQ)  and  CQ(Q)  with  respect  to  0  must  be  determined 
from  the  interpolation  scheme  used. 

Putting  all  of  this  together: 

ar„ 


Jo  = 


3com 

JUL 

3com 


du 
dF 
du 
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F-9  Ship  Dynamics  Model 
Interface  Variables 

Terminal  Potential  Variable         Flow  Variables     (KCL  Group)  Type 

Ship  Hydrodynamics  u  (import)  F  (export)  (0)  Normal 

Velocity  u  is  measured  in  meters/second  while  force  F  is  measured  in  Newtons. 

The  import  x^  and  export  xexp  vectors  are  given  by: 


xlmp  =  [u]  xap  =  [F] 


Parameters 


p  Density  of  Salt  Water  (kg/m3)  1025.9  kg/m3  @  15°  C. 

v  Kinematic  Viscosity  of  Water  (rrf/sec)  1.19x10"*  m2/sec  @15°  C. 

G  Acceleration  of  Gravity  (m/sec2)  9.80665  m/sec2 

L  Length  of  Ship  (m) 

As  Surface  Area  of  Ship  (m2) 

m  Mass  of  Ship  (kg) 

madd  Added  Mass  Multiplier  (PU)  (normally  between  1.0  and  1.10) 

Ca  Correlation  Allowance 

Cj(Re)  Matrix  of  Frictional  Drag  Coefficients  (2xn)  or  (3x/?) 

column  1  are  Reynolds  Number  Values 
column  2  are  Frictional  Drag  Coefficient  Values 
column  3  are  optional  first  derivative  values  of  the  curve 
Note:  Values  should  be  provided  for  negative  Reynolds  Numbers 

Cr(Fr)  Matrix  of  Residual  Drag  Coefficients  (2x«)  or  (3xn) 

column  1  are  Froude  Number  Values 
column  2  are  Residual  Drag  Coefficient  Values 
column  3  are  optional  first  derivative  values  of  the  curve 
Note:  Values  should  be  provided  for  negative  Froude  Numbers 


States 


There  are  no  states  associated  with  this  device 
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Equations 

The  basic  equations  are  given  by: 


R  = 


uL 


F  = 


CT  =  Cfll.)+Cr(Fr)  +  Cm 

F=-u  AsCT  +  m^m  — 

The  only  potential  difficulty  is  performing  the  evaluation  of  the  drag  coefficients 
C//U  and  Cr(Fr). 

Structural  Jacobian 


The  structural  jacobian  is  given  by: 


Jds  =  [N] 


Jacobian  Calculations 


f 


Jn=hA 


M(u)M(u) 


\ 


ldC/Re))       l     JdCr(Fr) 


-M 


dRt     )    JEg 


m^mS  x 


v 


dFr 


+  2M(u)M(C,(Re)) 


+ 


I 


where  5   is   the   integration  matrix   and  -^—   (        )   must   be   determined   by   either 
differentiating  the  Cj(Re)  (Cr{Fr))  curve  or  by  interpolating  the  third  colum  if  so  provided. 
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F-10  Pulse  Generator 
Interface  Variables 

Terminal  Potential  Variable         Flow  Variables    Type 

VO  V  (export)  Information 

The  import  x^  and  export  xexp  vectors  are  given  by: 


ximp  =  U  x«P  =  [V) 


Parameters 


VoJj  Value  of  V  when  off 

Von  Value  of  V  when  on 

tP  Matrix  of  pulse  times  (2x/?,): 

column  1  are  pulse  on  times. 

column  2  are  pulse  off  times. 

unlimited  number  of  n,  rows. 

States 

None 
Equations 

If  the  time  /  falls  between  an  on  and  an  off  time  then  V  -  Von,  otherwise  V  =  Voff. 

If  a  discontinuity  falls  within  the  time  interval,  the  earliest  discontinuity  time  should 
be  passed  back  as  a  recommended  recalculation  time.  The  time  of  the  next  discontiuity 
after  the  time  interval  should  also  be  made  available  to  the  system  solver. 

Structural  Jacobian 

There  is  no  structural  jacobian  matrix  for  this  device. 
Jacobian  Calculations 

There  is  no  jacobian  matrix  for  this  device. 


315- 


F-ll  Induction  Motor 


F-ll.l  ABC  Model 
Interface  Variables 

Terminal 

Phase  A 
Phase  B 
Phase  C 

Neutral 

Mechanical 


Potential  Variable        Flow  Variables    (KCL  Group)  Type 


VA  (Import) 
VB  (Import) 
Vc  (Import) 
V0  (Import) 

com  (Import) 


lA  (Export) 
IB  (Export) 
lc  (Export) 
10  (Export) 


(1)  Normal 
(1)  Normal 
(1)  Normal 
(1)  Normal 


Tm  (Export)  (0)  Normal 


Voltages  are  in  volts,  currents  in  amps,  angle  speed  in  radians  per  second  and 
Torque  in  Newton-meters. 

The  import  x^  and  export  xexp  vectors  are  given  by: 

VA 
VB 

Vc 


imp 


co. 


exp 


Parameters 


Rt 


lLS 


lLR 


VM 


(0, 


bs 


Pp 

B 


Stator  Resistance  (ohms) 

Rotor  Resistance  (reflected  to  Stator)  (ohms) 

Stator  Reactance  (ohms) 

Rotor  Reactance  (reflected  to  Stator)  (ohms) 

Mutual  Reactance  (ohms) 

Moment  of  Inertia  (Kg-m2) 

Base  Frequency  (radians  per  second) 

Pole  Pairs 

Windage  Torque  Factor  (Newton-Meters-second) 
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States 

6  Electrical  Rotor  Angle  (radians) 

Equations 

First  calculate  the  electrical  angle: 

Now  specify  the  following  stator  voltage  and  current  vectors: 


v5  = 


~vA- 

-v; 

V 

-v0 

Vc- 

-v0 

The  Rotor  voltages  and  currents  as  reflected  on  the  stator  are: 


V 


VR    = 


AR 

V 

VCR 


Calculate  the  inductances: 


h  = 


'Jar" 

*BR 
1CR 


K  = 


VLS 


CO, 


'hs 


v= 


x 


ut 


CO, 


'hs 


M^-l 


(o, 


'fa 


The  Stator  induction  matrix  is  given  by: 


2 
w     3 


^5  = 


0*+AJ 

2   "* 

rs      ms 

~2   ~ 

(A,+4J 

1 

~2ms 

~2   "" 

~2  ms 

(L^+LJ 

The  Rotor  induction  matrix  is  given  by: 
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v= 


(V+4J      ~-2Ks 


-k 


— L  (L/  +  L    )        — L 

/-\      ms  \     Is  ms'  **\      ms 


-k.     -k 


(V+AJ 


The  Mutual  induction  matrix  is  given  by: 


M(cos(G))L„ 


/ 


M 


cos 


/x        2* 

e+y 


A/ 


cos 


e- 

cosl  9  + 


V 


V 


271 

3 

2k 
3 


/.., 


ms 


A^(cos(0))Lw 


M 


cos 
V 

COS 


e- 


V 


V 


cos 


e- 


M(cos(0))L„ 


}J 


The  Rotor  and  Stator  resistance  matrices  are  given  by: 


R'=R, 


I 

0 

0" 

0 

/ 

0 

0 

0 

/_ 

R,  =  RS 


I 

0 

0" 

0 

/ 

0 

0 

0 

/ 

The  system  of  equations  which  need  to  be  solved  can  be  expressed  as: 


Rs  +  S   Ls        S   LSR 


i,  / 


for: 


s'\LSRy  r;+s-xlr 


For  a  squirrel  cage  induction  motor  v/-  0.    Hence  the  rotor  curents  can  be  solved 


1r  —  ARsls 


ars=-{r;+s-'lr')xs-\lsr')t 


ARS  =  -(SRr'+LRY(LSRy 

Now  the  stator  currents  can  be  solved  for. 
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™ss  ~  (°s  +  $    Ls  +  5    LSR  ARS) 


ls  -  Assvs 


The  neutral  current  is  solved  using  KCL; 


A)-    m     's     *c 


The  electrical  torque  is  given  by: 


T=- 


2XmPf 
3  co. 


'bs 


M{IA)M 


\ 


U- 


'AR 


J       >  T        >\ 

'BR        'CR 

~2        2 


+ 


M(L)M 


'BR 


\ 


'CR        JAR 

~2        2 


+ 


M(IC)M 


i  '  i  'Y\ 

.      ,       'AR        'BR 


sin(6)  + 


-(M(IA)M(IBRf  -  ICR')  +M{IB)M(ICR'  -  V)  +  M{IC)M{IAR'  -  IBRy>  cos(0)  | 


The  full  torque  equation  is  given  by: 

Tm=-Te  +  (JS-x+BI)v>„ 
Structural  Jacobian 


^DS  ~~ 


N  N  N  N  N' 

N  N  N  N  N 

N  N  N  N  N 

N  N  N  N  N 

N  N  N  N  N 
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Jacobian  Calculations 

The  jacobian   elements   corresponding   to   the   electrical    variables    are    easy    to 
calculate.  If  we  partition  the  jacobian  matrix  as  follows: 


where 


Ass 

AssUl 

J  EW 

/*= 

U\Ass 

U]ASSU, 

UUew 

JTE 

JTEu , 

Jtw 

Ui  = 


-1 
-1 
-1 


The  remaining  matrices  (Jew,  Jte,  and  7^)  are  not  as  easy  to  calculate: 


vs  -  ASs  h 


Take  the  partial  wrt  com: 


.    MS).  Li-,dis 


&5 

a©  ~  m 


-A^S 


_i  u(LSR  ARS) 
3com 


^sr  ARS  —    L^  (SRr  +LR)    (LSR  ) 


3d»  VW  =  _LsASR,  +    r  3^1  _^L(S/J/  +  V)-  (iffly 


3co, 


3co„       9co„ 


dLcp 


SR 


d(0„ 


M(sm(Q))LmsSp 


ms     r  p 


M 


(     f 
sin 


6  + 


2ti 


^\ 


LJSpB     M 

ms     r  p 


sin 


( 


M 


M 


sm 


9- 


271 


Spp  M(sin(0))L„^pp  M\  sin 


ms     r  p 


sirJ  6  + 


2ti 


Y\ 


^msSPp        M 


sirj  0- 


2ti 


*wSp, 


e- 


e  + 


271 


JSP. 


271 


Y\ 


A^P 


ms"  r  p 


M(sm(Q))LmsSp 


ms     r  p 
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Appendix  G:  WAVESIM  Program  Files 

WAVESIM  consists  of  ten  program  source  code  ( .  c)  files  plus  three  header  ( .  h)  files 
and  must  be  linked  to  the  standard  math  library.  Six  of  the  program  source  code  files  and 
two  of  the  header  files  are  specific  to  WAVESIM  while  the  remaining  files  contain 
application  independent  code. 

WAVESIM  SPECIFIC  FILES 


wave sim. c 
wavesim.h 
waveinit .c 

waveinit . h 
waveread . c 
wavebld . c 
wavewrit . c 
wavewrta . c 


Main  Executive  Routine 

Definition  of  WAVESIM  Structures 

Initialization  of  Structures 
Read  device . def 

Define  Initial  values  of  all  system  parameters 

Read  and  interpret  Input  File 

Build  System 

Write  MATLAB  .M  file 

Write  MATLAB  .M  file  (continued) 


APPLICATION  INDEPENDENT  FILES 


ioliba.c 
iolbia.h 
get_f  ile . c 
get line . c 
f ilebase . c 


String  Manipulation  Routines 
declarations  of  ioliba .  c  routines 
Prompt  for  and  open  files 
Obtain  string  from  an  input  stream 
File  name  manipulation  routines 
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G-l  Main  Program  File:  wavesim.  c 

wavesim.c  contains  the  main  routine  which  performs  the  executive  functions  for 
WAVESIM: 

1.  Initialize  device  definitions  init_devices 

2.  Print  the  Header 

3.  Open  Files 

4.  Read  Input  File  read_f  ile 

5.  Build  the  System  build_system 

6.  Write  The  Output  File  write_file 

7.  Close  the  Files 
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G-2  System  Initialization:  waveinit .  c 

waveinit .  c  contains  the  following  routines  for  initializing  the  system: 


init  devices 


read_device_def 

print_system_base 

print_device_def 

print_matrix 

print_structural_jacobian 

read_terminal 

read_parameter 

read_state 

r e ad_f un c t i  on 

read_stnactural_jacobian 

strip_white 

read  matrix 


Sets  Default  Values 

Calls  read_device_def  to  read  in 

device .  def  file. 

Debug  handler. 

Reads  in  device  .  def  file 

Prints  system  base  parameters 

Prints  a  Device  Definition 

Prints  a  Matrix 

Prints  a  Structural  Jacobian 

Interprets     TERMINAL     subordinate 
command 

Interprets    PARAMETER    subordinate 
command 


Interprets 
command 


STATE 


subordinate 


Interprets     FUNCTION     subordinate 
command 

Interprets  STRUCTURAL 

JACOBIAN  subordinate  command 

Strips  all  blanks,  tabs,  returns  from  a 
string. 

Reads  a  matrix. 
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The  hierarchy  for  the  routines  in  waveinit .  c  is  given  by: 

init_devices 

re  ad_de vi  c  e_de  f 
r  e  ad_t  e  nni  n  a  1 
read_parameter 
read_matrix 
read_state 
read_function 
read_structural_jacobian 
strip_white 
print_system_base 
print_device_def 
print_matrix 
print_structural_jacobian 
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G-3  Reading  Input  File:  waveread.c 

waveread.  c  contains  the  following  routines  for  reading  in  an  input  file: 

read_file  Controls   other   routines    for   reading 

input  files 
Debug  handler. 

read_file_device  Reads      and      Interprets       device 

command  from  input  file. 

read_file_default  Reads     and      Interprets      default 

command  from  input  file. 

read_f  ile_node  Reads  and  Interprets  node  command 

from  input  file. 

read_f  ile__time  Reads  and  Interprets  time  command 

from  input  file. 

read_file_debug  Reads       and       Interprets       debug 

command  from  input  file. 

print_debug  Print  debug  flag  status. 

print_time  Print  simulation  time  parameters. 

print__device  Print  device  characteristics. 

print_system  Print  system  characteristics. 

print_node  Print  node  characteristics. 

f  inish_reading_f  ile  Generate      cross       references       and 

generally     finish     the     process     of 
developing  the  initial  system. 
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The  hierarchy  for  the  routines  in  waveread .  c  is  given  by: 

read_file 

read_file_device 

print_device 
p r i nt_ma t r i x 

read_matrix 
read_file_default 

print_system_base 
r e  ad_f  i 1  e_n ode 

print_node 
read_file_time 

print_time 
read_f i le_debug 

print_debug 
f inish_reading_f  ile 
print_system 

print_device 

print_node 
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G-4  Building  the  System:  wavebid.c 

wavebld .  c  contains  the  following  routines  for  building  the  system: 

build_system  Identifies     System     variables     and 

equations 

Builds  cross  references 
Builds  System  Structural  Jacobian 
Reduces  system 


build_system_identify 
build_system_xref 


Identifies     system     variables     and 
equations. 

Builds  cross  references  within  the 
system. 


build_system_structural_ jacobian     Builds      the      system      structural 

jacobian  matrix. 


build_system__blocks 

f ind_block 

print_system_identify 
s  j_add 

s  j_sub 

print_system_block_s  jac 

print_block 


Identifies  the  sequence  of  blocks  for 
solving  system. 

Attempts  to  find  a  block  of  a  given 
size. 

Prints  system  information. 

Adds  two  Structural  Jacobian 
codes. 

Subtracts  two  Structural  Jacobian 
codes. 

Prints  the  block  owner  of  each 
element  in  the  system  sructural 
jacobian  matrix. 

Prints  information  about  a  block. 
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The  hierarchy  for  the  routines  in  wavebld .  c  is  given  by: 

build_system 

bu  i  1  d_s  y  s  t  em__i  dent  i  f  y 
print_system_identify 
build_system_xref 
build_system_structural_jacobian 

s  j_add 

sj_sub 
print_structural_jacobian 
build_system_blocks 

find__block 
print_block 

print_structural_jacobian 
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G-5  Writing  MATLAB  M-File:  wavewrit .  c  and  wavewrta .  c 

wavewrit .  c  and  wavewrta .  c  contain  the  following  routines  for  writing  the 
output  MATLAB  M-File: 


write_file 
write_file_header 
write_f  ile_initialize 
writ  e_f  i  1  e_t  ime_l  o  op 
write_f  ile_plot_variables 
write_f  ile_footer 
write   file   solve  block 


Calls     other     routines     to     generate 
MATLAB  M-File. 


Prints       header       information 
MATLAB  M-File. 


to 


Prints  System  Initialization 

parameters  to  MATLAB  M-File. 

Prints     Time     Loop     algorithm     to 
MATLAB  M-File. 

Prints     algorithm     to     plot     system 
variables  to  MATLAB  M-File 


Prints        Footer        information 
MATLAB  M-File. 


to 


Prints  algorithm  for  solving  block  to 
MATLAB  M-File. 


The  hierarchy  for  the  routines  in  wavewrit .  c  and  wavewrta .  c  is  given  by: 

write_f ile 

write_f  ile_header 
write_f  ile_intialize 
writ  e_f  i  1  e_t  ime_l  o  op 

write_f  ile_solve_jblock 
write  file  footer 
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G-6  Application  Independent  Files 

Several  Support  files  containing  special  C  functions  are  required  by  WAVESIM. 
These  files  were  written  by  the  author  independently  of  WAVESIM  and  may  contain 
routines  unused  by  WAVESIM. 

G-6.1  ioliba.  c 

ioliba .  c  contains  a  number  of  functions  for  manipulating  strings.   The  functions 
used  by  WAVESIM  are: 

Stoda 


strextract 

strsplit 

strstrip 

strncmpa 

strcmpa 


Converts  a  string  to  an  array  of  double  precision  floating 
numbers. 

Extracts  the  mh  word  of  a  string 

Returns  the  remainder  of  a  string  after  the  /7th  word. 

Strips  a  string  of  leading  and  trailing  spaces,  tabs,  and 
carriage  returns 

Case  insensitive  version  of  strncmp  for  comparing  the 
first  n  characters  of  two  strings. 

Case  insensitive  version  of  strcmp  for  comparing  two 
strings. 
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G-6.2  getline .  c 

getline.c  contains  functions  for  reading  in  lines  from  a  file  and  automatically 
implementing  the  following  features: 

1.  Comment  Lines  beginning  with  #,  ! ,  or  %  are  ignored. 

2.  Blank  Lines  are  ignored. 

3.  Lines  can  be  continued  with  ...  or  \. 

4.  If  the  first  word  of  the  line  is  INCLUDE  followed  by  a  filename,  lines  are  read 
from  that  file.  (NOTE:  A  check  for  recursive  INCLUDE  statements  is 
performed  to  prevent  infinite  loops) 

5.  Carriage  Returns  are  truncated. 
The  functions  used  by  WAVESEM  are: 
init_strm  Initialization  function 
get_line  Function  used  to  read  the  lines  in. 
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G-6.3  get_f  ile  .  c 

get_f  ile  .  c  contains  functions  for  opening  input  and  output  files.   The  following 
features  are  implemented: 

1.  Two  strings  are  passed:  a  default  filename  string  and  an  argument  filename 
string.  Either  or  both  strings  may  be  empty. 

2.  If  the  argument  filename  is  specified,  the  functions  attempt  to  open  that  file. 
If  opening  that  file  is  unsuccessful,  the  user  is  prompted  to  enter  a  new 
filename. 

3.  If  the  argument  filename  is  empty,  the  user  is  prompted  to  enter  a  filename.  If 
the  default  filename  is  not  empty,  it  is  offered  to  the  user  as  the  default  name 
of  the  file.  If  opening  the  file  entered  by  the  user  is  unsuccessful,  the  user  is 
prompted  to  enter  a  new  filename. 

4.  Users  can  exit  the  routine  without  opening  a  file  by  entering  only  a  q  when 
prompted  for  a  filename 

5.  Users  can  obtain  a  directory  listing  by  entering  a  ?  followed  by  whatever  file 
specification  the  user  desires. 

6.  Leading  and  trailing  spaces  in  filenames  are  truncated. 

7.  Whatever  filename  is  successfully  opened  is  passed  back  as  a  new  default 
filename. 

The  function  used  by  WAVESEM  is: 

get_input_f  ile       Function  for  opening  an  Input  File 

G-6.4  f  ilebase  .  c 

f  ilebase .  c  contains  functions  for  stripping  an  extension  off  of  a  filename  and  for 
returning  the  extension  of  a  filename.  The  following  features  are  implemented: 

1.  An  extension  is  defined  as  all  the  characters  after  the  last  period  (.)  found  after 
the  last  directory  delimiter  (\  for  IBM-DOS  and  /  for  UNIX).  If  no  such  period 
is  found,  the  extension  does  not  exist. 

The  function  used  by  WAVESIM  is: 

extract  base  Extract  the  base  filename  (without  extension) 
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G-7  Makefile 

The  UNIX  make  utility  greatly  eases  the  task  of  developing  programs  by  only  compiling 
those  files  which  have  changed  since  the  last  compilation.  Here  is  the  Makefile  used  to 
generate  WAVESEM  on  a  VAXstation  3100: 

#  Makefile  for  wavesim 
# 

#  For  Revision  2.0 
# 

FILES  =  wavesim. c  ioliba.c  getline.c  get_file.c  filebase.c  \ 

waveinit.c  waveread.c  wavewrit . c  wavewrta.c  \ 

wavebld. c 
OBJ   =  wavesim. o  ioliba.o  getline.o  get_file.o  filebase.o   \ 

waveinit.o  waveread.o  wavewrit. o  wavewrta.o  \ 

wavebld. o 
HEADER=  wavesim. h  ioliba.h 
CFLAG  =  -g 
COMPILE   =  cc 
# 
# 
# 
wavesim:  $ (HEADER)  $ (OBJ) 

$ (COMPILE)  -o  wavesim   $ (CFLAG)  $ (OBJ)  -lm 
wavesim. o:  $ (HEADER)  wavesim. c 

$  (COMPILE)  -c  $ (CFLAG)  wavesim. c 
ioliba.o:  ioliba.h  ioliba.c 

$ (COMPILE)  -c  $ (CFLAG)  ioliba.c 
getline.o:  getline.c 

$ (COMPILE)  -c  $ (CFLAG)  getline.c 
get_file.o:  get_file.c 

$ (COMPILE)  -c  $ (CFLAG)  get_file.c 
filebase.o:  filebase.c 

$ (COMPILE)  -c  $ (CFLAG)  filebase.c 
waveinit.o:  $ (HEADER)  waveinit.h  waveinit.c 

$ (COMPILE)  -c  $ (CFLAG)  waveinit.c 
waveread.o:  $ (HEADER)  waveread.c 

$ (COMPILE)  -c  $ (CFLAG)  waveread.c 
wavewrit. o:  $ (HEADER)  wavewrit . c 

$ (COMPILE)  -c  $ (CFLAG)  wavewrit . c 
wavewrta.o:  $ (HEADER)  wavewrta.c 

$ (COMPILE)  -c  $ (CFLAG)  wavewrta.c 
wavebld. o:  $ (HEADER)  wavebld. c 

$ (COMPILE)  -c  $ (CFLAG)  wavebld. c 

# 
# 
# 
lint: 

lint  $  (FILES) 
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